kookr-toolkit

A smart attention router for developers running multiple AI coding agents.

Features · Architecture · Roadmap · ADRs

You run 5 Claude Code agents in parallel. One silently loops on the same failing test for the 50th time. Another asks a permission question. A third drifts off-task. Which one needs you?

Kookr watches them all, detects failure patterns, and routes your attention to the agent that needs you most.

Watch the narrated demo video

Features

• Real-time monitoring — watches all your agents' event streams via Claude Code hooks
• Anomaly detection — catches stuck loops, repeated errors, permission blocks, idle agents
• Attention routing — prioritizes findings and auto-advances after you respond
• Quick reply — send hints or instructions to agents without leaving the dashboard
• Live terminal — xterm.js bridged to the agent's persistent dtach session
• AI suggestions — Claude Haiku generates response hints for detected anomalies
• Multi-agent support — launch Claude Code or Codex CLI agents from the same dashboard
• Multi-project tracking — register several project directories and see contributions across all of them
• Scheduled tasks — cron-style triggers for recurring agents (nightly scans, periodic supervision)
• GitHub integration — PR status, CI checks, and review threads for agent-created PRs
• Playbooks — reusable task templates discovered from three tiers: bundled with the kookr-toolkit plugin (visible everywhere), ~/.kookr/playbooks/ (per-user), and <repo>/.kookr/playbooks/ (project-local). See docs/playbook-scoping.md.
• Cost tracking — token usage and cost per session
• Session reflection — analyze friction patterns across supervision sessions

Quick Start

Prerequisites

• git
• Node.js >= 22 (tested with v24)
• pnpm >= 10
• Build tools for native module compilation (node-pty) and the vendored dtach binary
• Claude Code CLI (optional — required for launching agents, not needed for running the dashboard)

# Node.js 24 via NodeSource (tested version; v22 is also supported)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# Build tools + git — dtach is vendored and compiled via `pnpm build:dtach`
sudo apt-get install -y build-essential git

# pnpm
sudo npm install -g pnpm

# Xcode command line tools (provides git + build tools)
xcode-select --install

# Node.js + pnpm via Homebrew — dtach is vendored and compiled via `pnpm build:dtach`
brew install node@22 pnpm

Recording prerequisites

Only required if you plan to regenerate the demo video with pnpm demo:record. Skip this section otherwise.

• Color emoji font — Linux: sudo apt-get install fonts-noto-color-emoji && fc-cache -fv. macOS: ships with the system. A startup preflight (demo/lib/preflight.ts) refuses to record if Chromium can't render colored emoji.
• ffmpeg ≥ 5.0 — Linux: sudo apt-get install ffmpeg. macOS: brew install ffmpeg. Used to mux the captured video with TTS narration.
• Docker — only needed for the bundled TTS service (KOOKR_TTS=true). Skip if you record silent (KOOKR_TTS=) or point at an external TTS endpoint via KOOKR_TTS_URL.

Install & Run

git clone https://github.com/kookr-ai/kookr.git && cd kookr
pnpm install
pnpm dev         # backend on :4801 + Vite frontend on :5173

Open http://localhost:5173 in your browser. You're ready to launch and supervise agents.