██╗ ██╗ █████╗ ██████╗ ██╗ ███╗ ███╗ ██████╗
██║ ██╔╝ ██╔══██╗ ██╔══██╗ ██║ ████╗ ████║ ██╔═══██╗
█████╔╝ ███████║ ██████╔╝ ██║ ██╔████╔██║ ██║ ██║
██╔═██╗ ██╔══██║ ██╔══██╗ ██║ ██║╚██╔╝██║ ██║ ██║
██║ ██╗ ██║ ██║ ██║ ██║ ██║ ██║ ╚═╝ ██║ ╚██████╔╝
╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝
PRD-driven autonomous development for Claude Code.
You are the architect, agents are the builders.
Want to see exactly how KARIMO works? Check out the interactive demo to understand why it was built and how it works in detail.
┌──────────┐ ┌──────┐ ┌───────┐ ┌────────┐ ┌─────────────┐ ┌─────────┐
│ RESEARCH │──▸│ PLAN │──▸│ TASKS │──▸│ REVIEW │──▸│ ORCHESTRATE │──▸│ INSPECT │
└──────────┘ └──────┘ └───────┘ └────────┘ └─────────────┘ └─────────┘
│ │ │ │ │ │
└────────────┘ └──────────────┘ └──────────────┘
Loop 1 Loop 2 Loop 3
Human Claude Configurable
| Step | What Happens |
|---|---|
| Research | Discover patterns, libraries, gaps |
| Plan | Structured interview captures requirements |
| Tasks | Generate task briefs from research + PRD |
| Review | Claude validates briefs against codebase |
| Orchestrate | Execute in waves (parallel tasks, sequential waves) |
| Inspect | Review each PR (manual, Code Review, or Greptile) |
| Command | Purpose |
|---|---|
/karimo:research "feature" |
Start here — Create PRD folder + research |
/karimo:plan --prd {slug} |
Interactive PRD creation |
/karimo:run --prd {slug} |
Brief generation → review → execution |
/karimo:merge --prd {slug} |
Final PR to main |
/karimo:dashboard |
Monitor progress |
/karimo:feedback |
Capture learnings |
/karimo:doctor |
Diagnose issues |
Full reference: COMMANDS.md
KARIMO builds on Claude Code's native APIs with custom orchestration:
| Capability | Claude Code (Native) | KARIMO (Custom) |
|---|---|---|
| Isolation | Worktree per agent | + Branch identity verification |
| Execution | Task spawning | + Wave-ordered parallelism |
| Models | Static model: param |
+ Complexity routing + escalation |
| Recovery | Worktree persistence | + Git state reconciliation |
| Quality | — | + Semantic loop detection |
Why custom? Claude Code provides foundations (worktrees, sub-agents, hooks) but doesn't coordinate task dependencies, detect stuck loops, or recover from crashes. KARIMO adds these as a coordination layer.
Details: Feature Architecture
| Phase | What You Get |
|---|---|
| Phase 1 | PRD interviews, agent execution, worktrees, PRs — works out of the box |
| Phase 2 | Automated review via Greptile ($30/mo) or Claude Code Review |
| Phase 3 | CLI dashboard with velocity metrics |
Details: PHASES.md
/plugin marketplace add opensesh/KARIMO
/plugin install karimo@karimo
/reload-plugins
Once Anthropic accepts KARIMO into the official marketplace (in review), this becomes:
/plugin install karimo@claude-plugins-official
git clone https://github.com/opensesh/KARIMO
bash KARIMO/.karimo/install.sh ./my-projectIf you previously used .karimo/update.sh to sync files into your project's .claude/plugins/karimo/, it continues to work but is no longer the recommended path. Plugin-managed installs benefit from Claude Code's built-in update, reload, and scope management.
/karimo:research "feature-name" # Creates PRD folder + runs research
/karimo:plan --prd {slug} # Interactive PRD creation (~10 min)
/karimo:run --prd {slug} # Execute tasks in waves
/karimo:merge --prd {slug} # Final PR to mainPrerequisites: Claude Code, GitHub CLI (gh auth login), Git 2.5+
| Document | Description |
|---|---|
| Getting Started | Installation walkthrough |
| Commands | Full command reference |
| Architecture | System design, agents, feature breakdown |
| Phases | Adoption phases explained |
| Safeguards | Code integrity & security |
| Hooks | Lifecycle hooks (Slack, Jira, etc.) |
| Context Architecture | Token-efficient context layering |
| Compound Learning | How agents get smarter over time |
Can I run without automated review?
Yes. Review is optional (Phase 2). PRD interviews, execution, and PRs all work out of the box.
Do I need to use a feature branch?
No. KARIMO supports two modes configured via /karimo:configure: feature branch mode (tasks branch from a feature branch) or main mode (tasks branch directly from main). Choose what fits your workflow.
Can I run multiple sessions at once?
Yes, but be careful when running multiple feature branches with worktrees simultaneously. Typically when a feature branch and work trees are kicked off for a PRD, you only want to be doing research and planning on main. With Claude Opus 4.6, we've seen occasional conflicts. For best results, let one orchestration complete before starting another.
Do I need to use Greptile?
No. You can use manual review, Claude Code Review, or any other review mechanism. Greptile is one option for automated review in Phase 2, but it's entirely optional.
Can I use other tools for research?
Yes. We use Firecrawl MCP for deeper web research capability. You can integrate any MCP servers or tools that fit your workflow.
Can I customize for my use case?
Yes. You can modify your local installation directly or fork the repository for more extensive customization. Agent definitions, templates, and skills are all editable.
Having issues?
Run /karimo:doctor to diagnose. Still stuck? hello@opensession.co
See CONTRIBUTING.md
Built with Claude Code by Open Session