Why Tako? / 为什么用 Tako

• 🚀 One launcher, every tool — switch between Claude Code, Codex, Gemini in one TUI; no more juggling separate installs / 一个启动器管所有工具，不用分别折腾安装
• 🤖 Multi-agent sessions — run, monitor, and approve persistent agent sessions from the CLI; perfect for fan-out tasks / 多 agent 会话，CLI 里批量派活/监控/审批，适合并行任务
• 🔄 Per-session model switching — swap models via env var without polluting global config / 按会话切模型，不污染全局配置
• 🔌 Provider-agnostic — Tako API, Anthropic, DeepSeek, Xiaomi, or your own endpoint / 任意服务商，含自定义端点
• 🇨🇳 China-optimized — auto mirror detection + npmmirror acceleration / 自动镜像检测加速

Table of Contents / 目录

• Quick Install / 快速安装
• Usage / 使用方式
• Agent Session Management / Agent 会话管理
• Skills / 技能
• Features / 功能特性
• Documentation / 文档
• Development / 开发

What it looks like / 效果一览

$ tako
🐙 Tako — AI Coding Tools Launcher

  ▸ Claude Code   claude-sonnet-4-6   ● ready
    Codex         gpt-5.5             ● ready
    Gemini        gemini-2.5-pro      ● ready

  [←→] switch   [↑↓] projects   [a] agents   [p] providers   [Enter] launch

$ tako agent run claude --name fix-tests --json \
    --prompt "find and fix the failing auth tests"
→ run a1b2c3d4 (claude claude-sonnet-4-6)
  $ go test ./...
  ✗ FAILED (exit 1)
◀ turn done
{"sid":"a1b2c3d4-...","status":"ok","text":"Fixed 2 tests in auth_test.go"}

Quick Install / 快速安装

curl -fsSL https://cdn.jsdelivr.net/npm/tako-cli/install.sh | bash

Or via npm / 或通过 npm：

npm install -g tako-cli

China users: Tako automatically detects your region and uses npmmirror for fast installs. 国内用户：Tako 自动检测网络环境并使用 npmmirror 镜像加速安装。

Usage / 使用方式

tako                          # Interactive TUI launcher / 交互式启动器
tako --claude                 # Quick-launch Claude Code / 快速启动 Claude Code
tako --codex                  # Quick-launch Codex / 快速启动 Codex
tako --gemini                 # Quick-launch Gemini CLI / 快速启动 Gemini

TUI Shortcuts / TUI 快捷键

| Key | Action | |-----|--------| | ←→ | Switch between tools / 切换工具 | | ↑↓ | Navigate projects & options / 选择项目和选项 | | Enter | Launch / 启动 | | a | Agent management / Agent 管理 | | p | Provider settings / 服务商管理 | | q | Quit / 退出 |

Agent Session Management / Agent 会话管理

Manage persistent AI agent sessions from CLI or TUI. Sessions survive shell restarts.

从 CLI 或 TUI 管理持久化的 AI agent 会话。会话跨 shell 重启保持。

tako agent run claude --prompt "fix the failing tests" --json  # One-shot task / 一次性任务
tako agent start claude --model claude-sonnet-4-6   # Create session / 创建会话
tako agent list [--status idle --name-prefix fg-]    # List + filter / 列出+筛选
tako agent send <sid> "your prompt"                  # Send message / 发送消息
tako agent attach <sid>                              # Live-tail log / 实时跟踪
tako agent show <sid> --errors-only                  # Inspect failures / 查看失败详情
tako agent cancel <sid>                              # Cancel current turn / 中止当前轮
tako agent close <sid> [--purge]                     # Close session / 关闭会话

Advanced / 高级：

tako agent start codex --approval external           # External approval mode / 外置审批
tako agent approve <sid> <id> allow --rule "^curl"   # Approve + whitelist / 审批+加白
tako agent wait <sid> --json                         # Block until decision point / 阻塞到决策点
tako agent policy <sid> show                         # View policy / 查看策略

In TUI, press a to open the Agent page — create, monitor, send messages, and approve tool calls visually.

在 TUI 中按 a 进入 Agent 管理页 — 可视化创建、监控、发送消息和审批工具调用。

Skills / 技能

Tako bundles reusable skills that enhance Claude Code's capabilities. Install them to your project and Claude Code picks them up automatically.

Tako 内置可复用技能，增强 Claude Code 的能力。安装到项目后 Claude Code 自动识别。

Install via CLI / 通过 CLI 安装

tako skill list               # List available skills / 列出可用技能
tako skill install --all      # Install all / 全部安装
tako skill install tako-agent # Install specific / 安装指定技能

Install via GitHub / 通过 GitHub 安装

Copy the skill file directly from this repo into your project:

直接从仓库复制 skill 文件到你的项目：

# tako-agent skill
mkdir -p .claude/skills/tako-agent
curl -fsSL https://raw.githubusercontent.com/tako-dev/cli/main/skills/tako-agent/SKILL.md \
  -o .claude/skills/tako-agent/SKILL.md

# model-benchmark skill
mkdir -p .claude/skills/model-benchmark
curl -fsSL https://raw.githubusercontent.com/tako-dev/cli/main/skills/model-benchmark/SKILL.md \
  -o .claude/skills/model-benchmark/SKILL.md

Available Skills / 可用技能

| Skill | Description | 描述 | |-------|-------------|------| | 🤖 tako-agent | Agent session management — start/resume/monitor/close sessions | Agent 会话管理 — 启动/续接/监控/关闭会话 | | 📊 model-benchmark | Model capability scores from E2E testing across 16 models | 16 模型端到端评测能力评分 |

Features / 功能特性

| Feature | Description | |---------|-------------| | 🚀 Unified Launcher | One TUI for Claude Code, Codex, Gemini | | 🤖 Agent Sessions | Multi-session, persistent, approval workflow | | 🔄 Model Switching | Per-session via env var, doesn't pollute global settings | | 🔌 Provider Management | Tako API, Anthropic, DeepSeek, Xiaomi, custom | | 📦 Bundled Skills | Install to .claude/skills/ for agent enhancement | | 🇨🇳 China Optimized | Auto mirror detection, npmmirror acceleration |

Documentation / 文档

| Topic | Link | |-------|------| | 📖 Agent module design / Agent 模块设计 | docs/agent/DESIGN.md | | 🧪 Agent test plan / 测试计划 | docs/agent/TESTPLAN.md | | 🤖 tako-agent skill | skills/tako-agent/SKILL.md | | 📊 Model benchmark & picker / 选模型指南 | skills/model-benchmark/SKILL.md | | 🐛 Issues & feedback | GitHub Issues |

Development / 开发

bun install
bun run build
bun test

See CONTRIBUTING.md for the full workflow. / 完整流程见 CONTRIBUTING.md。

License

MIT