superclaw

SuperClaw

Claude Code plugin for agentic Mac automation, persistent memory, Telegram remote control, and multi-agent orchestration.

What It Does

SuperClaw turns Claude Code into a full autonomous workstation. One request auto-composes the right team of agents, executes in parallel, and verifies results independently.

• 36 MCP tools across 3 servers (bridge, peekaboo, memory)

• 10 team agents with 3-tier model routing (haiku / sonnet / opus)

• 9 skills with keyword auto-detection (Korean + English)

• 7 lifecycle hooks for context injection, tool enforcement, and session persistence

• Smart team routing — complex requests auto-compose multi-agent teams

• Sisyphus pattern — blocks session exit until autonomous tasks complete

• Obsidian sync — exports memory to interconnected markdown with [[wikilinks]]

Quick Start

# Clone
git clone https://github.com/jaminitachi/SuperClaw.git ~/superclaw
cd ~/superclaw

# One-command setup
npm run setup

# Launch Claude Code — SuperClaw loads automatically
claude

The setup wizard handles everything:

1. Installs Peekaboo (Mac automation) and SoX (audio)
2. Installs dependencies and builds 3 MCP servers
3. Configures Telegram bot (optional, interactive)
4. Registers as a permanent Claude Code plugin

Architecture

                         ┌─────────────────────────────────┐
                         │        Claude Code Session       │
                         │                                  │
                         │  ┌────────────────────────────┐  │
                         │  │     9 Lifecycle Hooks       │  │
                         │  │  keyword-detector (prompt)  │  │
                         │  │  session-start / session-end│  │
                         │  │  pre-tool / post-tool       │  │
                         │  │  subagent-tracker           │  │
                         │  │  persistent (Sisyphus)      │  │
                         │  │  pre-compact                │  │
                         │  └────────────────────────────┘  │
                         │                                  │
                         │  ┌────────────────────────────┐  │
                         │  │      10 Team Agents         │  │
                         │  │  Dev: dev-architect,        │  │
                         │  │    dev-backend, dev-frontend,│  │
                         │  │    dev-qa                   │  │
                         │  │  Research: research-reviewer,│  │
                         │  │    research-writer,          │  │
                         │  │    research-assistant        │  │
                         │  │  Infra: infra-monitor,      │  │
                         │  │    infra-mac                 │  │
                         │  │  Verify: verify             │  │
                         │  └────────────────────────────┘  │
                         └──────────┬───────────────────────┘
                                    │ MCP (stdio)
                    ┌───────────────┼───────────────┐
                    │               │               │
             ┌──────┴──────┐ ┌─────┴──────┐ ┌──────┴──────┐
             │  sc-bridge  │ │ sc-peekaboo│ │  sc-memory  │
             │  8 tools    │ │  15 tools  │ │  13 tools   │
             │             │ │            │ │             │
             │ Telegram    │ │ Screenshot │ │ SQLite+FTS5 │
             │ Cron sched. │ │ UI inspect │ │ Persistent  │
             │ Status      │ │ Click/type │ │  memory     │
             │ Routing     │ │ App mgmt   │ │ Obsidian    │
             └──────┬──────┘ │ AppleScript│ │  sync       │
                    │        │ OCR        │ │ Learnings   │
          ┌─────────┴─┐      └─────┬──────┘ │ Verification│
          │ Telegram   │           │        └─────────────┘
          │ Bot API    │     ┌─────┴──────┐
          └────────────┘     │  Peekaboo  │
                             │ (Homebrew) │
                             └────────────┘

Data Flow Example

User: "이 버그 고쳐줘" (Fix this bug)

1. UserPromptSubmit hook detects "고쳐" + "버그" → Debug Team
2. Team composition injected:
   - dev-backend (sonnet): Root cause analysis
   - dev-architect (opus): Architecture context
   - dev-qa (sonnet): Reproduce & verify
3. Agents execute in parallel
4. Stop hook blocks exit until work complete (Sisyphus)
5. Results verified independently before reporting

MCP Tools (36)

sc-bridge (8 tools)

Tool	Description
sc_send_message	Send Telegram message
sc_telegram_inbox	Get recent incoming messages
sc_telegram_status	Bot connection status
sc_route_command	Internal command router
sc_status	System-wide health check
sc_cron_list	List scheduled jobs
sc_cron_add	Add cron job (5-field expression)
sc_cron_remove	Remove cron job by name