ai-productivity-tracker
独立、自包含、可通过 npm 分发的 AI 编码会话提效追踪工具。 一个 npm 包同时承载:stdio MCP server + HTTP daemon + 浏览器看板 + Cursor/Claude IDE Hook,无需任何外部平台或后端服务。
エージェントを強化
公開元からインストールします。PlugMCP のエンドポイントではありません。
リモート URL か、手元のマシンのコマンドか 2 つのインストール方法の違い
PlugMCP で実行
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
起動~/.ai-productivity-tracker/data/,不上云,不联网。http://127.0.0.1:17350 实时展示,支持 6 个 Tab(需求看板 / 复盘经验 / 业务配置 / MCP 配置 / 工具说明 / 使用说明)。afterAgentResponse + stop hook、Claude Code Stop + UserPromptSubmit hook。# 1. 全局安装
npm install -g @ai-productivity-tracker/cli
# 2. 一键安装 IDE 配置(MCP + hooks.json + skill)
aipt install
# 3. 打开看板
aipt ui open
# → 浏览器自动打开 http://127.0.0.1:17350
完成。在 IDE 内开始正常工作,提效数据会自动落到看板。
aipt install 会自动写入 ~/.cursor/mcp.json(Cursor)与 ~/.claude.json(Claude Code),
效果分别等价于:
// ~/.cursor/mcp.json
{
"mcpServers": {
"ai-productivity-tracker": {
"command": "/abs/path/to/node",
"args": ["/abs/path/to/cli.mjs", "mcp"]
}
}
}
// ~/.claude.json (顶层会保留 Claude Code 自身的 numStartups / theme / projects 等字段)
{
"mcpServers": {
"ai-productivity-tracker": {
"type": "stdio",
"command": "/abs/path/to/node",
"args": ["/abs/path/to/cli.mjs", "mcp"]
}
}
}
无需配置任何环境变量或 token —— daemon 启动时自动生成,MCP 子进程通过 lockfile 拿。
aipt install --ide=cursor/aipt install --ide=claude可单独只装某一侧。
短别名
aipt与全名ai-productivity-tracker等价。
┌──────────────────────────────────────────────────────────────────────┐
│ 用户机器 │
│ │
│ IDE(Cursor/Claude Code) ──stdio──▶ npx aipt mcp │
│ │ │
│ ▼ │
│ ensureDaemon() ◄──singleton lock──┐ │
│ │ │ │
│ ▼ │ │
│ HTTP+Bearer ─────────────────────┘ │
│ │ │
│ ▼ │
│ Cursor hooks.json ──HTTP──▶ aipt daemon (127.0.0.1:17350) │
│ Claude settings.json hook ─────────────────────────│ │
│ ▼ │
│ 浏览器 ──fetch http://127.0.0.1:17350──▶ daemon API + 看板 SPA │
│ │ │
│ ▼ │
│ ~/.ai-productivity-tracker/ │
│ ├── runtime.json (pid/port/token)│
│ ├── config.json (用户偏好) │
│ └── data/ │
│ ├── <JIRA-KEY>/ │
│ │ ├── requirement.json │
│ │ └── iterations.jsonl │
│ ├── lessons/ │
│ ├── bindings.json │
│ └── ... │
└──────────────────────────────────────────────────────────────────────┘
详细架构见 docs/ARCHITECTURE.md。
最简部署不需要任何配置。如需调优:
完整配置项见 docs/PRD.md §10。
aipt doctor:逐项 ✓⚠✗ 输出体检报告(Node / daemon / mcp.json / hooks / skill / rule 等)。是排错第一步。aipt daemon 前台跑,查日志输出~/.ai-productivity-tracker/runtime.json token 已变,关掉 IDE 后重启即可AIPT_PORT=17888 aipt daemon 用其它端口更多见 docs/PRD.md §9。
ai-productivity-tracker/
├── docs/ # 设计文档(PRD/ARCHITECTURE/CHANGELOG/...)
├── packages/
│ ├── core/ # 数据模型 / store / watcher / metrics
│ ├── hook-core/ # Cursor/Claude hook 入口逻辑
│ ├── mcp/ # stdio MCP bridge(5 个 tool)
│ ├── server/ # HTTP daemon(30+ endpoint)+ skill-sync
│ ├── ui/ # Vue 3 看板 SPA
│ └── cli/ # 单 npm 包发布主体,argv-router + 11 子命令
└── skills/ # Skill / Cursor Rule 模板(随 cli 包发布)
开发命令:
pnpm install # 安装全部 workspace 依赖
pnpm typecheck # 全包 tsc 检查
pnpm test # 全包 vitest(当前 612 例)
pnpm lint # ESLint 9 flat config
pnpm format # Prettier 3
pnpm --filter @ai-productivity-tracker/cli build # 链式 ui build + esbuild bundle
pnpm --filter @ai-productivity-tracker/ui dev # 开发态 SPA(自动 proxy /ai-productivity 到 daemon)
# 首次设置专用发布账号(token 落在项目级 .npmrc.publish,不污染 ~/.npmrc)
npm login --userconfig=./.npmrc.publish --auth-type=web --scope=@ai-productivity-tracker
# 干跑(不真发,验证产物 + 体积 + 登录态)
pnpm release prerelease
# 真发
pnpm release prerelease --publish # → x.y.z-rc.N+1
pnpm release patch --publish # → x.y.(z+1)
pnpm release 1.0.0 --publish # → 显式版本
scripts/release.mjs 自动:typecheck → test → lint → bump → build →
体积校验(< 3MB tarball)→ npm whoami 验证 → publish → git commit + tag。
详见 docs/CHANGELOG.md 内"发布工程经验"段。
设计文档完整版:docs/PRD.md
独立、自包含、可通过 npm 分发的 AI 编码会话提效追踪工具。 一个 npm 包同时承载:stdio MCP server + HTTP daemon + 浏览器看板 + Cursor/Claude IDE Hook,无需任何外部平台或后端服务。
ツール
ツール一覧はまだありません。リモートサーバーは、最初のヘルスチェック後に取得されます。
よくある質問
このページで Cursor、Claude Desktop、Claude Code、VS Code 用の stdio 設定をコピーできます。PlugMCP のプロキシではなく、公開元のインストール方法を使います。
このレコードに必須の環境変数は記載されていません。
Ai Productivity Tracker は stdio 経由でローカル実行されます。
最終チェックは 2026-10-28 です。 独立、自包含、可通过 npm 分发的 AI 编码会话提效追踪工具。 一个 npm 包同时承载:stdio MCP server + HTTP daemon + 浏览器看板 + Cursor/Claude IDE Hook,无需任何外部平台或后端服务。