mcpField
T
Tare

Tare

本地服务
tare.priberry.com数据与分析12 天前更新

关于 Tare

Tare 分析本地编码 Agent 日志,估算 Token 成本并找出可避免的用量,还提供兼顾缓存的优化和成本凭据。它面向跟踪 Agent 用量的开发者,在本地运行,不上传数据,也不调用模型。

主要功能

  1. 01本地 Agent 日志成本分析
  2. 02Token 用量明细
  3. 03兼顾缓存的输出精简
  4. 04缓存状态与倒计时
  5. 05每次提交的成本凭据
  6. 06用于用量报告的 MCP 工具

适用场景

  1. 01按时间查看编码 Agent 成本
  2. 02查找重复或开销较大的上下文输出
  3. 03精简工具输出且不改写历史
  4. 04比较优化前后的每次提交成本

MCP 相关

Tare 可通过 stdio 作为 MCP 服务运行,并提供 `tare_wrapped`、`tare_receipt` 和 `tare_cache`。其 setup 命令可将 Tare 添加到检测到的 AI 编码应用中。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"priberry-data-tarelab": {
"command": "npx",
"args": [
"-y",
"tarelab"
]
}
}
}
启动命令npx -y tarelab

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmtarelab0.2.0

工具

3

收录的工具列表 · 更新于 1 天前

参数类型必填说明
daysnumber否时间范围(天);0 表示全部时间。默认值为 30。

详细介绍

tare

完成相同工作,消耗更少令牌,还有凭据。

你的编码 Agent 会记录它发出的每次 API 调用。Tare 会读取这些日志,为每个令牌计价,并展示钱花在了哪里:Claude Code、Codex CLI、Gemini CLI,以及 VS Code 中的 Cline、Roo Code 和 Kilo Code,还有 Cursor、Windsurf 和其他基于 VS Code 的编辑器。对于 ChatGPT 计划中的 Codex,Tare 还会显示你距离计划用量上限还有多远。然后,它会在不破坏提示词缓存的前提下减少浪费,并用你自己的工作证明每一笔节省。它在本地运行,不会上传任何内容,也不会调用模型。

npx tarelab
  YOUR AGENT, WRAPPED  · last 30 days · 254 sessions · 79,905 API calls

  $6,720 API-equivalent spend
  $623 of it was avoidable (9%)

  Where it went
  Reading cached context     ██████████████████████ $3,809
  Writing to the cache       ████████████ $2,072
  Output (thinking incl.)    █████ $838

  The highlights
  › ~82k tokens load before you type a word.
  › Coffee-break tax: $722 re-caching after 636 pauses.
  › Sub-agents spent $2,734 (41%).

Priberry 自己使用 Claude Code 的真实一个月记录。

命令

命令功能
tare汇总最近 30 天的数据。--days N、--all、--json、--logs <dir>
tare card生成可分享的 1200×630 卡片(SVG,附带 PNG 下载)和帖子文案。不会上传任何内容
tare fix安装输出精简功能和缓存状态行。--dry-run、--undo、--scope project
tare receipt对比 tare fix 前后的每次提交成本,附带 90% 区间和完成率检查
tare status查看已安装的内容,以及输出精简功能目前削减了多少输出
tare setup将 Tare 添加到这台机器上的所有 AI 编码应用。--dry-run、--undo
tare mcp通过 stdio 运行的 MCP 服务:tare_wrapped、tare_receipt、tare_cache

数字的计算方式

  • API 等效成本。 每次调用都按 Anthropic API 的公开价格计价:新输入、缓存写入(5 分钟缓存按输入价格的 1.25 倍计,1 小时缓存按 2 倍计)、缓存读取和输出。订阅采用固定费用;这里显示的是同样的工作通过 API 完成时的成本。
  • 持续成本。 工具的输出会写入缓存一次,并在之后的每次调用中读取,直到对话被压缩。Tare 会按输出在上下文中保留的整个时长计费。
  • 缓存重建。 如果提示词的大部分内容被重新写入缓存,而不是从缓存读取,Tare 会说明原因:空闲时间超过缓存有效期、切换模型、压缩,或中断。
  • 重复内容。 工具调用返回的内容与 Agent 已有内容逐字节相同。

修复

Tare 会在浪费进入上下文时将其削减,并且绝不重写已有内容,因为重写历史会破坏提示词缓存,造成的成本会超过节省的成本。

  • 输出精简(Bash 上的 PostToolUse 钩子):超过约 2,500 个令牌的输出会被精简为前 40 行、所有看起来像失败的信息(附带上下文),以及最后 60 行。完整输出会保存到 ~/.tare/out/,并告知 Agent 文件位置。
  • 缓存倒计时(状态行):显示缓存失效前的剩余时间,以及下一条消息在缓存可用和不可用时的成本。仅当你尚未设置状态行时才会安装。

设置会先备份到 ~/.tare/backups/,而 tare fix --undo 只会移除 Tare 添加的条目。

凭据

tare receipt 会比较修复前后各会话的每次提交成本,并提供 bootstrap 90% 区间,同时检查仍能完成提交的会话数量是否相同。如果任一侧已完成的会话少于 8 个,它会显示“数据不足”,不提供数字。

在你的 Agent 中使用

运行一条命令,即可将 Tare 添加到它找到的所有 AI 编码应用:Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Codex、Gemini CLI、Kiro、opencode、Amazon Q、LM Studio,以及 Cline、Roo Code 和 Kilo Code。条目会固定到确切版本,每个文件都会先备份,运行 --undo 即可移除。

npx tarelab setup

也可以一次配置一个应用:

  • Claude Code 插件: /plugin marketplace add priberry-data/tarelab,然后运行 /plugin install tare@priberry。
  • Gemini CLI 扩展: gemini extensions install https://github.com/priberry-data/tarelab
  • 技能(Claude Code 或 Codex): 将 skills/tare 复制到 ~/.claude/skills/ 或 ~/.codex/skills/。
  • 任意 MCP 客户端: {"command": "npx", "args": ["-y", "[email protected]", "mcp"]}。然后询问:“我的 Agent 这个月花了多少钱?”

限制

Tare 会读取 Agent 保存在你设备上的日志。Cursor 自带的 Agent、Windsurf 的 Cascade、Copilot 以及浏览器应用构建工具(Lovable、Bolt、v0、Replit)会将用量记录在自己的服务器上,因此 Tare 暂时无法查看;接下来将支持 opencode。Cline 系列的费用来自扩展自身记录的数据。fix 和 receipt 命令适用于 Claude Code,因为其中提供了钩子。工具输出的 token 数量根据文本长度估算(API 报告的是每次调用的总量,而非每个区块的数量)。Anthropic 的价格截至 2026-10-06,OpenAI 和 Google 的价格截至 2026-11-08,均记录在 src/prices.mjs 中。

Apache-2.0 · 由 Priberry 构建,他们也开发了 Crumple。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。