🐾 CodeClaw
A project-agnostic task and idea management plugin for Claude Code
CodeClaw gives your AI-assisted development workflow a structured backbone: ideas are captured, evaluated, promoted to tasks, implemented with quality gates, and tracked to completion — all through plain-text files and Claude Code slash commands. A gated release pipeline enforces strict development rules from branch creation to production tagging.
📖 Full Documentation — Architecture, API reference, configuration, deployment, troubleshooting, and more.
✨ Features
- 🔄 Two-pipeline workflow — separate idea evaluation from task execution
- 🛠️ 9 streamlined skills — unified slash commands (
/task, /idea, /release, /docs, /setup, /update, /tests, /help, /crazy)
- 🚦 Gated release pipeline — 9 sequential stages with user-confirmed gates, feedback loops, and mandatory local build verification before every push
- 🏷️ Explicit version bump gate — all manifest files are discovered, verified, and updated with user confirmation before tagging
- 🌿 Three-branch strategy — enforced
develop → staging → main promotion path with mandatory staging validation
- 🐳 Docker tagging — staging builds the
latest tag, production builds stable + versioned tags
- 🧩 Claude Code plugin — install via marketplace, uninstall cleanly, update easily
- 📝 Plain-text tracking — tasks and ideas live in simple
.txt files, fully version-controllable
- 🔗 GitHub/GitLab Issues integration — optional tri-modal sync with GitHub or GitLab Issues
- ✅ Quality gates — verification, linting, and smoke tests run before tasks can be closed
- 💻 Cross-platform — works on Linux, macOS, and Windows with automatic OS detection
- 🌐 Project-agnostic — works with any language, framework, or tech stack
- 👤 Human-in-the-loop — AI assists, but you make every decision at every gate
- ⚡ Yolo mode — append
yolo to any command to auto-confirm all gates for fully autonomous execution
🆕 What's New in v4.0.5
- 🧹 Release cleanup — 4.0.4 documentation and changelog corrections are now carried through the release line
- 🌿 Branch alignment —
develop, staging, and main now share the same release history and tree
- 📝 Docs simplification — public docs and API reference no longer advertise retired legacy doc flows
- 🤖 [BETA] /crazy skill — fully autonomous end-to-end project builder
- 🎨 Frontend design wizard — template search, theme selection, color palette picker
- 🐾 Rebranded — CTDF → CodeClaw with plugin id
claw
📋 Prerequisites
- Claude Code CLI installed and configured
- 🐍 Python 3.12+ (used by the bundled scripts)
📦 Installation
From Marketplace
/plugin marketplace add https://github.com/dnviti/codeclaw
/plugin install claw@dnviti-plugins
Local Development
git clone https://github.com/dnviti/codeclaw.git
claude --plugin-dir ./codeclaw
🚀 Getting Started
-
Install the plugin using one of the methods above.
-
Set up task tracking in your project:
/setup My Project Name
This creates the task/idea files (to-do.txt, progressing.txt, done.txt, ideas.txt, idea-disapproved.txt), configures the three-branch strategy, and writes project guidance to project-context.md while creating AGENTS.md.
-
Start using skills:
/idea create Add user authentication with JWT
/idea approve IDEA-AUTH-0001
/task pick
/task status
-
When ready to release:
/release continue 1.0.0
⚙️ How It Works
CodeClaw enforces strict development rules through two connected pipelines and a gated release process.
💡 Idea Pipeline
Ideas are lightweight proposals — what and why only. They must be explicitly approved before entering the task pipeline.
flowchart LR
A[ideas.txt] -->|/idea approve| B[to-do.txt<br>becomes a task]
A -->|/idea disapprove| C[idea-disapproved.txt<br>archived]
📋 Task Pipeline
