Karajan Code

Install Karajan Code globally via npm. Alternatively use Homebrew on macOS, download a standalone binary (no Node.js required), or run the one-line shell installer.

# npm (recommended)
npm install -g karajan-code

# Homebrew (macOS)
brew install manufosela/tap/karajan-code

# One-liner installer
curl -fsSL https://raw.githubusercontent.com/manufosela/karajan-code/main/scripts/install-kj.sh | sh

Run kj init inside your Git repository. The wizard auto-detects installed AI agents, frameworks, and optional services (Docker, SonarQube), and writes a .karajan/kj.config.yml project config. It also asks once whether to enable anonymous telemetry (off by default).

cd /path/to/your-project
kj init

Run kj doctor to confirm all detected agents and optional dependencies are correctly wired. This surfaces missing CLI tools or mis-configured paths before you run a real pipeline.

kj doctor

Pass a plain-English task description to kj run. Karajan orchestrates the full pipeline: intent classification, planning, coding (TDD-first), SonarQube gate, review, and test verification. For quick coding without review use kj code.

# Full pipeline
kj run "Add input validation to the user registration endpoint"

# Coder only (skips review loop)
kj code "Fix the off-by-one error in the pagination helper"

Karajan auto-registers its MCP server after installation. If manual setup is needed, add the following block to your Claude config file (~/.claude.json). This exposes 27 tools including kj_run, kj_code, kj_review, kj_plan, kj_audit, and kj_rag_query.

{
  "mcpServers": {
    "karajan-mcp": {
      "command": "karajan-mcp"
    }
  }
}

Create or edit .karajan/kj.config.yml in your project to assign different AI agents to specific pipeline roles and enable optional stages like the architect, refactorer, or commiter.

agents:
  coder: claude
  reviewer: codex

pipeline:
  roles:
    planner: true
    researcher: true
    architect: false
    refactorer: false
    commiter: false

rag:
  preload:
    enabled: true
    topK: 5
  embedder:
    provider: ollama

telemetry: false