"The crab that pinches between conversations—your zero-cost cognitive claw for Claude Code orchestration."
🧠 What Is Claude-Zeroclaw?
Claude-Zeroclaw is a decentralized sidecar daemon that sits between your terminal and Claude Code CLI sessions. It acts as a contextual router, sub-agent orchestrator, and prompt augmentation layer—all without incurring additional token costs beyond your standard Claude API usage.
Think of it as a cognitive claw that reaches into your local filesystem, your ongoing conversation threads, and your MCP tool definitions, then pinches the most relevant context into every Claude Code invocation—automatically, transparently, and at zero additional overhead.
Unlike traditional proxy solutions that simply forward requests, Zeroclaw understands your workflow topology: it learns which files you edit together, which skills you invoke in sequence, and which Claude Desktop sessions you reference most often. It then builds a context graph that evolves across your entire development session.
🦀 Core Metaphor: The Hermit Crab
Imagine a hermit crab that carries its shell from place to place. Claude-Zeroclaw is that shell—but instead of a home, it carries your conversational context:
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
# Start Zeroclaw daemon
zeroclaw daemon --profile developer-fullstack
# In another terminal, use Claude Code as usual
claude "Refactor the authentication middleware to use JWT"
Advanced Invocation with Sub-Agents
# Invoke Claude Code through Zeroclaw with explicit sub-agent routing
claude --zeroclaw "Deploy the microservice to staging" \
--subagent code-reviewer \
--subagent test-writer \
--context-inject recent:3 \
--session-resume last
Desktop ↔ CLI Sync
# Sync current Claude Desktop session to CLI
zeroclaw sync --from desktop --to cli --session analysis-123
# Result: Claude Code CLI now has all context from Desktop session
claude "Continue the analysis from where I left off on Desktop"
🔌 API Integration
OpenAI API + Claude API Dual Mode
Claude-Zeroclaw supports routing to either API based on task complexity:
| Task Type | Default API | Fallback |
|-----------|-------------|----------|
| Code generation | Claude 4.5 Sonnet | GPT-4o |
| Documentation | GPT-4o | Claude 4.5 Sonnet |
| Security analysis | Claude 4.5 Sonnet | None |
| Test writing | Claude 4.5 Sonnet | GPT-4o |
| Customer support | GPT-4o mini | Claude 4.5 Sonnet |
Zeroclaw includes a built-in skill library that can be extended:
| Skill | Purpose | Example |
|-------|---------|---------|
| sanitize-prompt | Removes accidental API keys, secrets, PII | When a user accidentally pastes credentials |
| augment-context | Inserts relevant files from session memory | Automatically includes the file you were editing |
| decompose-task | Splits complex requests into sub-tasks | "Create a full CRUD API" → route, controller, model, tests |
| route-to-subagent | Assigns sub-tasks to appropriate sub-agents | Code review → code-reviewer, tests → test-writer |
| aggregate-results | Merges sub-agent outputs into one coherent response | Combines code + tests + docs into single reply |
📊 SEO-Friendly Keywords (for discoverability)
This repository actively targets the following search terms naturally throughout its documentation and metadata:
Claude Code CLI context management
Zero-cost AI orchestration (note: "zero-cost" refers to no additional software fees, not API costs)
MCP tools integration for Claude
Claude sub-agent workflow automation
Multilingual Claude assistant
Claude Desktop to CLI sync
Sub-agent decomposition for Claude Code
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
⚠️ Disclaimer
Claude-Zeroclaw is an independent open-source tool and is not affiliated with, endorsed by, or sponsored by Anthropic or OpenAI. All trademarks, service marks, and company names referenced herein—including "Claude," "Claude Code," "Claude Desktop," "OpenAI," and "GPT"—are the property of their respective owners.
This software is provided "as is" without warranty of any kind, express or implied. Users are responsible for:
Complying with the terms of service of any third-party APIs they connect
Ensuring they have appropriate API keys and billing configured
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
