CLI 参考
说实话,这就是个 Python 脚本包。几行命令扔进去,它就能帮你扒开 Claude Code 的账单,看看有多少 token 是在交智商税。
快速安装
curl -fsSL https://raw.githubusercontent.com/KevinYoung-Kw/stoi-cli/main/install.sh | bash
uv 安装(最快)
uv tool install stoi-cli
pipx 安装
pipx install stoi-cli
装完之后运行 stoi help 看看能不能响。如果提示 command not found,请把 ~/.local/bin 加到 PATH 里。这是基础常识,不是 bug。
CLI 命令速查
所有命令都可以通过 stoi <command> 直接调用,或者进 REPL 后用 /<command>。本质上就是python日志解析器加上一个帮腔作势的终端彩打脚本在帮你算账。
分析最新 session,告诉你含屎量和缓存命中率。最简单的查账入口。
生成一个花花绿绿的 HTML 报告并自动打开浏览器。适合截图发朋友圈装逼。
启动本地服务,给你一个带逐轮分析的可视化面板。比终端体面一点。
启动实时监控代理,在你下一段对话开始前就埋伏好。有点 stalker,但有用。
选两个 session 做 before/after 对比。直观地证明你优化(或者搞砸)了多少。
配置 LLM Provider、API key、模型等参数。填错就报错,很诚实。
显示所有可用命令的简要说明。迷路时的紧急出口。
REPL 交互式命令
运行 stoi(不加参数)进入一个丑但好用的交互式 REPL。这是日常使用最频繁的模式,你可以边聊边查,不用每次都重新敲命令。
当前 session 的含屎量简报。适合对话中途突然想查账。
就地生成并打开 HTML 分析面板。REPL 里一键装逼。
粘贴 System Prompt,定位导致 cache miss 的嫌疑字段。甩锅专用。
一键把 STOI 塞进 Claude Code 当 Skill。配置粗暴但有效。
全局效率报告,汇总所有历史 session。看看你一共烧了多少冤枉钱。
切换要分析的 session(claude / opencode / gemini)。多平台渣男追踪器。
基于 LLM 生成深度优化建议。需要配置 API key,天下没有免费的建议。
退出 REPL。去干活吧,别光查了。
MCP 集成
STOI 同时也是一个 MCP Server。如果你把 stoi 接入 Claude Code,Claude 可以直接调用以下工具来分析自己的效率。在 REPL 里敲 /mcp 就能完成配置。说白了就是把 CLI 的功能以 JSON-RPC 的形式暴露出去,方便 Claude 自己查自己。
stoi_latest— 获取最近一次 session 摘要stoi_report— 对指定 session 做完整分析stoi_insights— 基于知识库的优化建议stoi_overview— 全局 token 效率统计stoi_blame— 扫描 System Prompt 里的 cache-busting 模式