KARIMO

PRD-driven autonomous agent orchestration harness plug-in for Claude Code.
You are the architect, agents are the builders.

See It In Action

Want to see exactly how KARIMO works? Check out the interactive demo to understand why it was built and how it works in detail.

How It Works

Commands

Full reference: COMMANDS.md

What KARIMO Adds

KARIMO builds on Claude Code's native APIs with custom orchestration:

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

Adoption Phases

Details: PHASES.md

Installation

Via Claude Code marketplace (recommended)

Once Anthropic accepts KARIMO into the official marketplace (in review), this becomes:

Via install script (legacy)

If 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.

Your First Feature

Prerequisites: Claude Code, GitHub CLI (gh auth login), Git 2.5+

Documentation

FAQ

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,…