TAKT — Multi-Agent Workflow Orchestration CLI

Why TAKT?

AI coding agents are powerful, but they don't automatically create a stable development process.

Plain AI Agents

The prompt asks the agent to follow a process
Review steps can be forgotten or skipped
One long context keeps growing
Implementation and review responsibilities blur
The same process must be recreated by memory

With TAKT

The YAML workflow owns the process
Review and fix loops are explicit transitions
Each step receives only the context it needs
Personas, permissions, and output contracts separate roles
Workflows are reusable, reviewable, and versionable

How It Works

1

Talk

            $ takt
> Add JWT authentication
          

Describe your task to the AI assistant. TAKT helps you refine requirements and queue it.

2

Run

$ takt run

Execute tasks in isolated worktrees. TAKT handles planning, implementation, review, and fix loops automatically. A PR is created when done. No GitHub? Works locally too.

Features

🎼

YAML Workflows

Define plan, implement, review, and fix loops as explicit state machine steps with rule-based routing.

🎭

Faceted Prompting

Split prompts into personas, policies, knowledge, instructions, and output contracts. Each step gets only what it needs.

🔄

Review Loops

Parallel multi-reviewer steps with automatic fix loops. Reviews can't be silently skipped.

🤖

Multi-Provider

Claude Code, Claude SDK, Codex, OpenCode, Cursor, GitHub Copilot, and Kiro. Mix providers per step.

🌲

Isolated Worktrees

Tasks run in git clones. Auto-commit, push, and PR creation. No pollution of your working tree.

👥

Team Leader

Dynamic task decomposition with parallel worker dispatch. One leader plans, multiple workers execute.

🔗

GitHub / GitLab

Create tasks from issues, auto-create PRs/MRs, and close issues on merge. Works with both GitHub and GitLab.

📦

Repertoire Packages

Share and install workflow packages from GitHub. Community-driven workflow ecosystem.

📊

Observability

OTLP traces, session logs, usage analytics, and per-step reports. Full auditability from task to PR.

✅

Quality Gates

Run build, lint, and tests automatically before a step completes. Fail fast, not after merge.

🛡️

Loop Monitors

Detect and stop infinite review-fix cycles automatically. No more runaway token spend.

🔧

Builtin Workflows

Ready-to-use workflows for frontend, backend, CQRS/ES, dual-stack, review, audit, and maintenance.

"What we estimated would take 100% of the effort, TAKT got it done at 20%."

— Enterprise user feedback

Define Your Process

Workflows are simple YAML. Here's the core idea:

steps:
  - name: plan
    persona: planner
    instruction: Analyze the task and create an implementation plan.
    rules:
      - condition: Plan approved  next: implement

  - name: implement
    persona: coder
    edit: true
    instruction: Implement according to the plan.
    rules:
      - condition: Implementation complete  next: review

  - name: review
    parallel:
      - persona: architecture-reviewer
      - persona: security-reviewer
    rules:
      - condition: All approved  next: COMPLETE
      - condition: Needs fix     next: fix

  - name: fix
    persona: coder
    edit: true
    rules:
      - condition: Fixed  next: review

Works With Your Stack

Use any combination of providers. Assign different agents to different workflow steps.

Claude Code Claude SDK Codex OpenCode Cursor GitHub Copilot Kiro

Get Started in 5 Minutes

npm install -g takt

Also available via Nix: nix run github:nrslib/takt

Star on GitHub Read the Docs Join Discord