Claude Code Integration with it2

it2 provides built-in state detection, helper plugins, and a Claude Code plugin marketplace for orchestrating Claude Code sessions inside iTerm2 panes.

Marketplace Plugins

The repository checked-in manifest (.claude-plugin/marketplace.json) defines six plugins:

Plugin Path Description
it2 ./integrations/claude-code/plugins/it2 Session-work analysis
core ./integrations/claude-code/plugins/it2-core iTerm2 terminal automation agent and commands
claude-automation ./integrations/claude-code/plugins/it2-claude-automation Claude Code settings and hook configuration
claude-irc ./integrations/claude-code/plugins/it2-claude-irc IRC-style /join, /msg, /who session commands
claude-plugin-development ./integrations/claude-code/plugins/it2-claude-plugin-development Scaffolding tools for plugin and marketplace authoring
claude-agent-development ./integrations/claude-code/plugins/it2-claude-agent-development Specialized agents for creating and testing Claude Code agents

Quick Start

Add the marketplace and install desired plugins from Claude Code:

# Add marketplace from local repository or GitHub
/plugin marketplace add tmc/it2

# Install plugins from the it2 marketplace:
/plugin install it2@it2
/plugin install core@it2
/plugin install claude-automation@it2
/plugin install claude-irc@it2
/plugin install claude-plugin-development@it2
/plugin install claude-agent-development@it2

Driving Claude Sessions with it2

You can drive Claude Code sessions programmatically using it2 CLI subcommands:

#!/usr/bin/env bash
# Illustrative Fragment: Launching Claude Code in a worker pane

# 1. Create a split pane for the Claude worker
WORKER_SID=$(it2 session split --vertical --quiet)

# 2. Label the session badge
it2 session badge set "Claude" "$WORKER_SID"

# 3. Send startup command to worker session
it2 session send-text "$WORKER_SID" "claude"