Agent TUI

基于 LangChain + LangGraph + DeepAgents 的终端 Agent 脚手架，支持 ACP 协议与编辑器（Zed / VS Code ACP Client）交互。

安装（npm）

# 全局安装 CLI
npm install -g @tangtaue/agent-tui

# 或项目内使用
npx @tangtaue/agent-tui

# 配置 API Key（复制示例后编辑）
cp node_modules/@tangtaue/agent-tui/.env.example .env
# 填入 DEEPSEEK_API_KEY / OPENAI_API_KEY 等

# 启动 TUI
agent-tui

# ACP 模式（供 IDE 连接）
agent-tui-acp

npm 包名 @tangtaue/agent-tui。CLI 命令仍为 agent-tui / agent-tui-acp。

特性

• TUI 终端：类似 Claude Code / Codex Terminal 的交互界面
• ACP 模式：通过 stdio JSON-RPC 供 IDE 连接
• 多模型：在 agent.config.yaml 配置 OpenAI / Anthropic / DeepSeek，TUI 内 /model 切换
• 文件读写：使用 DeepAgents 内置 read_file / write_file / edit_file，工作区由 agent.config.yaml 限制
• MCP：读取 mcp.json / .cursor/mcp.json 等配置，动态加载 MCP 工具
• Skills：扫描项目、全局、.cursor、.claude、.codex 等目录下的 SKILL.md 并注入 Agent

快速开始

cd agent-tui
pnpm install --ignore-workspace

# 方式一：复制 .env.example 为 .env 并填入 DEEPSEEK_API_KEY（推荐，已 gitignore）
cp .env.example .env

# 方式二：临时导出环境变量
# export DEEPSEEK_API_KEY=sk-...

# 终端 TUI 模式
pnpm dev

# ACP 模式（供编辑器连接）
pnpm dev:acp

# 查看 Skills / MCP
pnpm dev skills
pnpm dev mcp

DeepSeek 配置

| 参数 | 值 | |------|-----| | OpenAI 兼容 base_url | https://api.deepseek.com | | Anthropic 兼容 base_url | https://api.deepseek.com/anthropic | | api_key | 环境变量 DEEPSEEK_API_KEY | | model | deepseek-v4-flash / deepseek-v4-pro |

export DEEPSEEK_API_KEY=你的密钥
pnpm dev -- --model deepseek:deepseek-v4-flash

TUI 内 /model 可切换 OpenAI API 与 Anthropic API 两种接入方式。

编辑器接入（ACP）

在 Zed 或 ACP Client 中添加 Agent：

{
  "command": "npx",
  "args": ["@tangtaue/agent-tui", "acp"]
}

配置

主配置文件：agent.config.yaml

| 区块 | 说明 | |------|------| | models | 多模型列表 | | mcp | MCP 配置路径与内联 servers | | skills | Skills 扫描目录 | | agent.workspace | 工作区根目录；. 表示启动 CLI 时的当前目录（非 npx 包目录） | | filesystem | 工作区读写限制 | | acp | ACP Agent 名称 |

项目级 MCP 可写入 mcp.json（与 Cursor 格式兼容）。

目录结构

agent-tui/
├── agent.config.yaml    # 主配置
├── mcp.json             # MCP 服务器（Cursor 兼容）
├── src/
│   ├── cli.ts           # CLI 入口
│   ├── acp/             # ACP 协议服务
│   ├── agent/           # DeepAgent 运行时 + MCP + 文件工具
│   ├── config/          # 配置 / Skills / MCP 加载
│   └── tui/             # Ink TUI 界面
└── package.json

技术栈

• TypeScript 7（Go 原生编译器，tsc 构建）
• deepagents — LangGraph Deep Agent
• @agentclientprotocol/sdk — ACP 协议
• ink — React TUI

构建与发布

pnpm install --ignore-workspace
pnpm run build          # TypeScript 7 编译到 dist/
pnpm run build:watch    # 监听模式
pnpm run typecheck      # 仅类型检查

# 发布到 npm（需先 npm login）
npm pack --dry-run      # 预览打包内容
npm publish --access public

独立子仓库

本目录可作为独立 Git 仓库维护：

cd agent-tui
git init
git remote add origin [email protected]:<user>/agent-tui.git