项目简介

Track CLI是一个专为AI代理设计的项目进度跟踪工具，通过MCP协议向LLM客户端提供项目状态、任务信息和文件上下文。

主要功能

• 层次化任务管理：项目 → 功能 → 任务的树状结构
• AI友好接口：提供稳定的JSON输出供程序化使用
• 多代理安全：使用SQLite WAL模式支持并发访问
• 文件关联：将文件与任务关联以维护上下文
• 状态跟踪：支持计划中、进行中、完成、受阻、被替代五种状态
• 最小化API：只有5个核心命令，易于学习和使用
• 智能过滤：默认只显示活动任务，减少上下文噪音

安装步骤

1. 克隆仓库并安装依赖：

git clone https://github.com/lackeyjb/track-cli
cd track-cli
npm install
npm run build
npm link

服务器配置

该MCP服务器可通过以下配置集成到AI客户端中：

Claude Code 配置（~/.claude.json）：

{
  "mcpServers": {
    "track-cli": {
      "command": "track",
      "args": ["mcp", "start"]
}

Codex 配置（~/.codex/config.toml）：

[mcp.track-cli]
command = "track"
args = ["mcp", "start"]

自定义端口和主机：

track mcp start --port 8877 --host 127.0.0.1"

基本使用方法

1. 初始化项目：

track init "我的项目"

2. 创建任务：

track new "用户认证" --summary "实现登录和登出功能" --next "从登录表单组件开始"

3. 关联文件：

track new "登录表单" --parent <功能ID> --file src/components/LoginForm.tsx

4. 查看状态：

track status --json