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.

• 41 MCP tools across 3 servers (bridge, peekaboo, memory)
• 29 specialized agents with 3-tier model routing (haiku / sonnet / opus)
• 15 skills with keyword auto-detection (Korean + English)
• 9 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                │  │
                         │  └────────────────────────────┘  │
                         │                                  │
                         │  ┌────────────────────────────┐  │
                         │  │     29 Specialist Agents    │  │
                         │  │  Orchestration: prometheus, │  │
                         │  │    metis, momus, atlas      │  │
                         │  │  Dev: architect, debugger,  │  │
                         │  │    reviewer, test-engineer  │  │
                         │  │  Research: paper-reader,    │  │
                         │  │    lit-reviewer, data-analyst│  │
                         │  │  Infra: mac-control, cron,  │  │
                         │  │    pipeline, memory-curator │  │
                         │  └────────────────────────────┘  │
                         └──────────┬───────────────────────┘
                                    │ MCP (stdio)
                    ┌───────────────┼───────────────┐
                    │               │               │
             ┌──────┴──────┐ ┌─────┴──────┐ ┌──────┴──────┐
             │  sc-bridge  │ │ sc-peekaboo│ │  sc-memory  │
             │  8 tools    │ │  15 tools  │ │  18 tools   │
             │             │ │            │ │             │
             │ Telegram    │ │ Screenshot │ │ SQLite+FTS5 │
             │ Cron sched. │ │ UI inspect │ │ Knowledge   │
             │ Status      │ │ Click/type │ │  graph      │
             │ 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:
   - sc-debugger (sonnet): Root cause analysis
   - sc-architect (opus): Architecture context
   - sc-test-engineer (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 (41)

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