Your creative dev tool — AI coding Swiss Army knife
Quick Start • Why ClawCode • Features • Documentation • Contributing
ClawCode is an open-source coding-agent CLI for Anthropic, OpenAI, Gemini, DeepSeek, GLM, Kimi, Ollama, Codex, GitHub Models, and 200+ models via OpenAI-compatible APIs. It goes beyond code generation — it's a self-improving engineering partner.
| Typical AI Coding Tool | ClawCode |
|---|---|
| Suggestion-only chat | Terminal-native execution |
| One-shot answers | Self-improving learning loop |
| Single model, single thread | 14-role virtual R&D team |
| No memory | Persistent sessions + experience capsules |
| Vendor lock-in | 200+ models, fully configurable |
Idea → Memory → Plan → Code → Verify → Review → Learned Experience
Analyze, code, verify, and review — all in one surface. No IDE overhead, no context switching.
clawcode # Interactive TUI
clawcode -p "Refactor this API" # Non-interactive
clawcode -p "Summarize changes" -f json # JSON outputClawCode features ECAP (Experience Capsule) and TECAP (Team Experience Capsule) — a closed-loop learning system that turns every task into reusable knowledge:
- Instinct → Experience → Skill evolution chain
- Automatic write-back from
/clawteam --deep_loop - Portable, feedback-scored, privacy-controlled capsules
Spin up specialist design agents (research, IXD, UI, product, visual) and ship structured design specs — not just "chatty UI suggestions."
Orchestrate 14 professional roles in one command:
| Role | Focus |
|---|---|
| Product Manager | Priorities, roadmap |
| System Architect | Architecture, tech choices |
| Backend / Frontend / Mobile | Implementation |
| QA / SRE | Quality, reliability |
| DevOps / Team Lead | CI/CD, decisions |
/clawteam "Build a REST API with auth" # Auto-assign roles
/clawteam --deep_loop "Design microservice arch" # Convergent iteration| Category | Examples |
|---|---|
| File I/O | view, write, edit, patch, grep |
| Shell | bash, terminal, execute_code |
| Browser | browser_* (×11 automation tools) |
| Agent | Subagent spawning with isolation |
| Integration | MCP, Sourcegraph, Desktop automation |
Migration-friendly: supports .claude/agents/, Claude-style tool names, plugin/skill systems, and familiar slash workflows.
cd clawcode
python -m venv .venv
.\.venv\Scripts\Activate.ps1 # Windows
pip install -e ".[dev]"
clawcode -c "/path/to/project"Requirements: Python >=3.12, one LLM provider credential.
| Topic | Link |
|---|---|
| Architecture | docs/architecture.md |
| Agent & Team Orchestration | docs/agent-team-orchestration.md |
| ECAP/TECAP Learning System | docs/ecap-learning.md |
| Slash Commands Reference | docs/slash-commands.md |
| Configuration Guide | docs/clawcode-configuration.md |
| Performance & Testing | docs/clawcode-performance.md |
| Suite | Tests | Status |
|---|---|---|
| Unit + Integration | 833 | ✅ |
| CLI Flags | 22 | ✅ |
| TUI Interactions | 27 | ✅ |
| Real Skills + Plugins | 53 | ✅ |
Total: 944 items. 935 passed, 9 skipped, 0 failed.
| Level | Time | Steps |
|---|---|---|
| Run it | ~5 min | Install → clawcode -p "..." → try /clawteam |
| Close the loop | ~30 min | Real task → /clawteam --deep_loop → inspect write-back |
| Team rollout | Repeatable | Align model → inventory skills → wire ECAP feedback |
pytest
ruff check .
mypy .For larger design changes, open an issue first.
AI tooling may run commands and modify files. Use ClawCode in a controlled environment, review outputs, and apply least privilege.
GPL-3.0 license.
Built by DeepElementLab
