tokenpilot (Rish E)

TokenPilot

自动令牌优化 克劳德代码。通过减少每个维度上的浪费令牌来延长会话持续时间——努力调优、冗余文件读取、工具成本路由、上下文健康跟踪和智能任务分类。

运作原理

TokenPilot分为四层运行：

1. 钩子 --拦截Claude代码生命周期事件（会话开始、提示提交、工具使用前/后）
2. MCP服务器 --公开用于实时控制和监控的工具
3. SQLite数据库 --使用WAL模式+可序列化隔离跨钩子子进程调用持久化会话状态
4. 工具注册表 --将已知工具映射到估计成本和更便宜的替代方案

┌── Claude Code Hooks ──────────────────────────────────────┐
│                                                            │
│  SessionStart        → init session, inject hints          │
│  UserPromptSubmit    → classify task → suggest effort      │
│  PreToolUse (Read)   → dedup file reads + suggest cheaper  │
│  PostToolUse (all)   → track real tool output token costs  │
│                                                            │
└────────────────┬───────────────────────────────────────────┘
                 │
    ┌────────────▼──────────────────┐
    │   TokenPilot MCP Server       │
    │                               │
    │   set_level(1-10)             │  Aggressiveness dial
    │   get_stats()                 │  Live session metrics
    │   get_savings()               │  Token savings report
    │   get_context_health()        │  Context window status
    │   get_tool_report()           │  Most expensive tools
    │   get_file_report(path)       │  File read history
    │   explain_classification(p)   │  Debug classifier
    │   reset_file_tracking()       │  Clear dedup cache
    │                               │
    │   SQLite + Tool Registry      │  Persistent state
    └───────────────────────────────┘

攻击性量表

违约： 4 （保守平衡）。可随时通过以下方式调节1-10 /tp level N.

思维上限具有适应性 --它们根据任务复杂度和分类器置信度进行缩放。“琐碎”的任务比“复杂”的任务受到更严格的限制。如果分类器不确定（置信度\ |设置攻击性级别| | /tp on / off |启用/禁用tokusanpilot| | /tp stats |完整会话控制面板| | /tp note |在项目大脑中添加注释| | /tp explain ` |调试提示分类的原因|

MCP工具

对于高级用户，所有工具都可以直接调用：

set_level toggle get_stats get_savings get_context_health get_tool_report get_file_report explain_classification add_note reset_file_tracking

CLI（用于测试）

cd ~/MCPs/tokenpilot

python3 server.py init 4                    # Initialize session
python3 server.py classify "fix typo"       # Classify prompt
python3 server.py classify_debug "fix typo" # Debug classification
python3 server.py check_file "/src/app.py"  # Check file dedup
python3 server.py context_health            # Context window status

项目大脑

TokenPilot自动维护 tpcontext.md 每个项目根目录中的文件。这是Claude Code会话中的持久内存——当你开始一个新的聊天时，Claude会立即知道你在哪里停了下来。

全自动：

• 首次安装 --从git历史中引导（提交、活动文件、分支）
• 每次会话开始 --自动保存前一个会话，将大脑加载到上下文中
• 无需手动保存 --它只是工作

它捕捉到了什么：

• 修改的文件（来自git diff）
• 最近的提交
• 用户备注（通过 /tp note "...")
• 会话统计数据（持续时间、提示计数）
• 最活跃的文件

为未来的会议添加上下文：

/tp note "switched to GraphQL — don't touch REST endpoints"

保持在2K代币以下。保留最后5个会话，旧会话轮换。

智能警告

TokenPilot会自动检测并警告令牌浪费模式：

• 快速射击提示 --连续3条以上的短信会触发“批量提问”建议
• 会话年龄 --每15个提示，建议 /compact 或重新开始
• 高峰时段 --太平洋时间工作日上午5点至11点，每节课警告一次（高峰时段人为烧伤限制更快）

所有警告显示为 [TokenPilot] 消息，并尊重开/关切换。

文件结构

tokenpilot/
├── server.py            # FastMCP server + CLI entry point
├── classifier.py        # Task classifier (v2: negation, adjacency, debug)
├── config.py            # Aggressiveness scale + adaptive thinking caps
├── db.py                # SQLite persistence (WAL, indexed, serializable)
├── brain.py             # Project Brain — auto-generated tpcontext.md
├── tool_registry.py     # Tool cost estimates + cheaper alternatives
├── tracker.py           # In-memory tracker (used by MCP server process)
├── requirements.txt
├── commands/
│   └── tp.md            # /tp slash command (copy to ~/.claude/commands/)
├── hooks/
│   ├── session_start.sh # SessionStart — init + load brain
│   ├── classify.sh      # UserPromptSubmit — classify + rapid-fire + peak hours + session age
│   ├── check_read.sh    # PreToolUse (Read) — dedup + tool routing
│   └── post_tool.sh     # PostToolUse — real token tracking
└── templates/
    └── claudeignore-default

代币储蓄如何堆叠

许可证

麻省理工学院