TMA1

这个 Agent 能做什么，适合哪些场景？

TMA1 是一套本地优先的 LLM Agent 可观测工具，由 GreptimeDB 驱动，以单个二进制形式运行在你自己的机器上，不需要 Docker、Grafana 或云账号。它通过 OTLP/HTTP 接收 Claude Code、Codex 等 Agent 的 traces、metrics 与 logs，同时采集 hook 事件和 JSONL 会话记录，全部写入本机的 GreptimeDB（默认 HTTP 端口 14000）。随后它把观测结果反向注入 Agent：hook 返回的内容会变成下一轮的 <tma1-context> 上下文块，另有十个 MCP 工具支持按需查询会话状态、异常、构建结果和历史会话全文检索。面板端提供 token 用量、成本估算、延迟、工具活动、会话回放和 SQL 查询。部署形态是一台机器上的后台服务（launchd、systemd 用户单元或 Windows 计划任务），数据目录固定为 ~/.tma1/，而项目本身不含认证，属于纯本地工具。

TMA1 的 tma1-server 监听 14318 端口，同时承担 OTLP 反向代理、hook 接口 /api/hooks、面板托管和 MCP stdio 服务四项职责。OTLP 数据（/v1/otlp 或 /v1/traces、/v1/metrics、/v1/logs）被转发给首次启动时自动下载并以子进程拉起的 GreptimeDB；hook 脚本 POST 到 /api/hooks，响应体会成为 Agent 下一轮的上下文。Claude Code 会注册全部 27 个 hook 事件，但只有 SessionStart、UserPromptSubmit、PostToolUse、Stop、PreCompact 五个会注入内容；Codex 注册五个、注入四个。tma1 build -- <cmd>（可加 --watch、--tag、--filter-regex）包裹构建或测试命令，把输出写入 tma1_build_events，用于构建状态与重复失败检测。MCP 侧（tma1-server mcp-serve）暴露 get_context_bundle、get_session_state、get_anomalies、get_build_status、get_external_changes、get_project_state、get_peer_sessions、search_sessions、get_session_transcript、exec_query 十个工具，exec_query 只允许单条只读 SELECT。查询还有另外三个入口：TMA1 面板、MySQL 协议端口 14002、以及 GreptimeDB 自带的面板。

1. 长时间用 Claude Code 或 Codex 写代码的开发者，希望下一轮对话自动带上“本次会话改过哪些文件、构建是否挂了”的上下文。
2. 用 npm run dev 之类常驻进程开发的人，用 tma1 build --watch 捕获失败输出，让 Agent 直接看到报错而不是靠人贴日志。
3. 在同一项目里混用 Claude Code 和 Codex 的团队，用 /tma1-peer codex 让一个 Agent 读到另一个在相同项目上的工作记录。
4. 需要回溯“上周哪次会话讨论过重试退避”的工程师，用 /tma1-search retry backoff 在本机历史中做全文检索并读取会话原文。
5. 想量化 token 花费、缓存命中与工具失败的负责人，用面板的会话对比和成本估算做评估。
6. 想用 SQL 自己分析原始 traces、metrics、logs 的数据工程人员，通过 MySQL 协议或 GreptimeDB 面板直接查询。

如何安装或部署这个 Agent？

macOS 或 Linux 用一键脚本，并通过 TMA1_ADAPTER 指定要接入的 Agent：

curl -fsSL https://tma1.ai/install.sh | TMA1_ADAPTER=claude-code bash
curl -fsSL https://tma1.ai/install.sh | TMA1_ADAPTER=codex bash
curl -fsSL https://tma1.ai/install.sh | TMA1_ADAPTER=all bash

不接任何 Agent、只装服务端：

curl -fsSL https://tma1.ai/install.sh | bash

Windows PowerShell：

$env:TMA1_ADAPTER = 'claude-code'; irm https://tma1.ai/install.ps1 | iex

脚本会注册后台服务并启动，完成后面板在 <http://localhost:14318>。首次启动会下载 GreptimeDB（默认 v1.3.0），无需 Docker 或云账号。从源码构建：

git clone https://github.com/tma1-ai/tma1.git
cd tma1
make build
./server/bin/tma1-server

如何使用这个 Agent？

接入后，Agent 每轮会自动拿到 <tma1-context> 上下文块。手动管理适配器：

tma1-server install --adapter claude-code --project .
tma1-server uninstall --adapter claude-code --project .

捕获构建或测试输出：

tma1 build --tag test -- make test
tma1 build --watch --tag dev -- npm run dev

启动 MCP 服务（通常由 Agent 自行拉起，也可手动验证）：

tma1-server mcp-serve

在 Agent 里使用内置命令与工具：

/tma1-search retry backoff
/tma1-search --session 3d8f1d0a
/tma1-peer self --limit 3

常用环境变量：

TMA1_PORT=14318
export TMA1_DATA_DIR=~/.tma1
export TMA1_DATA_TTL=60d
export TMA1_LLM_API_KEY=...   # 仅按需的 prompt 评估功能需要
export TMA1_LLM_PROVIDER=anthropic
export TMA1_DISABLE_INJECTION=1  # 只记录 hook，不注入上下文

原生 SQL 可在 MySQL 协议端口 14002 或 GreptimeDB 面板查询。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.3.0-beta4 预发布 2026-10-30
   发布说明摘录

   What's Changed * feat(pricing): price cache reads, cache writes and OpenAI Fast mode by @killme2008 in https://github.com/tma1-ai/tma1/pull/113 Full Changelog: https://github.com/tma1-ai/tma1/compare/v0.3.0-beta3...v0.3.0-beta4

   在 GitHub 查看 ↗

常见问题