Frugal Tokens 

Frugal Tokens 是一款专为开发者设计的轻量级、本地化监控工具，透明化各类 AI 编码代理（Coding Agents）的 Token 消耗与成本结构。它支持 OpenCode、Claude Code、PI、Codex 和 Cursor 等主流平台，通过只读方式解析本地会话日志，为用户提供详尽的支出来源分析、模型使用分布及缓存命中率报告，帮助团队和个人更精准地控制 AI 辅助开发的预算。

核心功能亮点

• 细粒度成本拆解：
  • 不仅显示总体使用情况，还能深入分析支出来源。
  • 区分不同模型（如 GPT-4o, Claude Sonnet 等）的调用成本。
  • 特别关注**缓存未命中（Cache Misses）**情况，帮助用户识别因上下文重复率低而导致的额外开销。
• 效率与重叠分析：
  • 统计预计工作时间，评估 AI 辅助的实际产出效率。
  • 检测重叠会话，避免多终端或多实例同时运行造成的资源浪费。
• 纯本地与只读安全：
  • 零数据上传：所有数据处理均在本地完成，不向任何第三方服务器发送敏感代码或对话内容。
  • 只读访问：仅读取本地存储的会话日志文件，不修改任何原始数据，确保环境安全。
• 多平台支持：
  • 全面兼容 OpenCode, Claude Code, PI, Codex, Cursor 等流行编码代理工具的会话格式。

快速开始指南

1. 前置要求

• 安装 Deno 2.9 或更高版本。

2. 安装步骤 (macOS / Linux)

# 安装 Deno
curl -fsSL https://deno.land/install.sh | sh

# 克隆项目并进入目录 (假设已 git clone)
cp .env.example .env

# 构建并启动应用
deno task build && deno task start

3. 访问仪表盘

启动成功后，打开浏览器访问 http://localhost:9000 即可查看分析报告。

配置说明

• 自定义会话路径：
  编辑 .env 文件，修改默认的会话日志存储位置，以适配不同的工具或用户配置。
• 端口配置：
  • 若默认端口 9000 被占用，可在 .env 中设置 PORT=9001（或其他可用端口）。
  • 该变量也适用于 Railway 等自动注入端口的托管环境。
• 开发模式：
  • 运行 deno task dev 启用热重载。
  • 默认访问 http://localhost:5273。
  • 注意：开发模式下 API 端口由 Web 端口动态计算，忽略 .env 中的 PORT 设置。如需更改开发 API 端口，请指定不同的 Web 端口，例如 deno task dev 5274。

适用场景

• 个人开发者：监控个人订阅额度的消耗速度，优化 Prompt 策略以提高缓存命中率。
• 技术团队 Lead：评估团队内 AI 工具的使用效率，识别高成本低产出的异常会话。
• 财务/运维人员：在不接触代码内容的前提下，审计 AI 相关的云服务支出明细。