AgentTakt MCP server

<!-- mcp-name: io.github.ryoohshima/agenttakt -->

AgentTakt is an MCP (Model Context Protocol) server and TUI tool. When an AI agent (an "Executor" such as Claude Code) sends a task execution plan over MCP, AgentTakt renders it as a node graph in your terminal. You review it with mouse and keyboard — move, add, and delete nodes, draw dependency edges, edit parameters — then approve, and the edited plan JSON is returned to the Executor for execution.

Claude Code (Executor)
   │ stdio (MCP)                        your other terminal
   ▼                                           │
[agenttakt serve] ── Unix domain socket ──▶ [agenttakt (TUI)]
 MCP server                               review / edit / approve

Features

• Terminal-native — no web UI; everything runs inside your terminal
• Visual node editor — rounded nodes, dependency edges, and per-type coloring, powered by Textual
• Mouse-first editing — drag nodes to move them, draw edges between ports (rubber band), click to select and delete
• Safe approval loop — cycle detection (DAG guarantee) and other validations at the entry point, returning errors the agent can self-correct

Requirements

• Python 3.10+ (recommended: uv)
• A terminal emulator with mouse reporting (iTerm2, WezTerm, kitty, Ghostty, ...)

Installation

If you have uv, no installation is needed. uvx agenttakt fetches and runs AgentTakt on demand, and the .mcp.json example below starts the MCP server the same way.

If you don't have uv, install AgentTakt once:

brew install ryoohshima/tap/agenttakt    # Homebrew
pipx install agenttakt                   # pipx

Installing is also handy for everyday use even with uv — you start the TUI by hand, so plain agenttakt beats typing uvx agenttakt each time:

uv tool install agenttakt

Agent Plugins

This repository is an Agent Plugins 1.0.0 package. In a compatible client, load the repository root as the plugin directory:

AgentTakt/
├── plugin.json     # Portable plugin manifest
├── mcp.json        # MCP server configuration
└── LICENSE

The plugin requires uvx on PATH and runs the published agenttakt package from PyPI. Its uv cache is stored under the client-managed PLUGINDATA directory. Start the TUI separately with uvx agenttakt before using the tools. For requestapproval, configure a sufficiently long tool timeout in your client (for example, 30 minutes); the portable MCP format has no timeout field.

The development .mcp.json is a separate client-native configuration that runs the local checkout. server.json supplies metadata for the MCP Registry.

Quick Start

AgentTakt runs as two processes: the MCP server, which Claude Code starts for you, and the TUI, which you start yourself in a separate terminal. The TUI is what displays the plan, so start it before asking the Executor for approval.

Shortened. The full README is on GitHub.