Tokless
在多个编程智能体中统一安装代码分析、上下文压缩与精简指令工具。
- Star 数
- ★ 274
- 最近更新
- 11 天前
- License
- MIT
- 主语言
- Go
- FA 评分
- 57/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 开始前需要
- 典型场景
- 同时使用 Claude Code、Codex 或其他受支持客户端，希望用一个命令保持工具与指令配置一致的开发者。
- 主要局限
- 安装命令直接把从 GitHub 下载的脚本交给 Bash 或 PowerShell 执行，采用前需要自行评估远程脚本与其写入范围。
这个 Agent 能做什么，适合哪些场景？
Tokless 是一个面向编程智能体的跨平台安装与配置 CLI，可在 macOS、Linux 和 Windows 上运行。它把 karpathy-skills、caveman、ponytail、rtk、codegraph 和 context-mode 组合为一套统一工具链，并为不同智能体写入相应的指令、Hook、插件、扩展或 MCP 配置。其支持范围包括 Claude Code、OpenCode、Codex、Antigravity、GitHub Copilot、Factory Droid、Pi、Cursor、Grok Build、Kilo Code、Oh My Pi 和 Cline，但具体接入方式及功能覆盖因客户端而异。安装程序检测本机已有的受支持智能体，让用户选择一个、多个或全部目标；之后可通过同一 CLI 更新、诊断、禁用或卸载配置。它的部署边界是用户本机的智能体配置和项目代码图索引，并不提供独立的模型、托管编码服务或统一聊天界面。
运行 tokless 后，安装程序会检测已安装的受支持编程智能体，并按选择接入 rtk、caveman、ponytail、codegraph 和 context-mode。caveman、ponytail 以及表中列出的 karpathy-skills 提供静态编程与响应指令；rtk 在命令输出到达智能体前进行过滤；codegraph 建立源代码、调用路径和影响关系的索引；context-mode 提供带会话记忆的沙箱化上下文分析。Tokless 根据目标客户端写入 Instruction、Hook、Allow、Plugin、Extension 或 MCP 配置，并公开 codegraph_explore、ctx_execute、ctx_batch_execute、ctx_execute_file、ctx_index、ctx_search 和 ctx_fetch_and_index 等 MCP 工具。tokless index 构建逐项目的 codegraph 索引，tokless doctor 检查已接入内容并提示损坏项，tokless update 更新 CLI、显示版本差异并升级工具。
- 同时使用 Claude Code、Codex 或其他受支持客户端，希望用一个命令保持工具与指令配置一致的开发者。
- 需要为大型代码库建立代码图，以便查看源码关系、调用路径和修改影响的团队。
- 经常遇到终端输出挤占上下文窗口，希望在输出进入编程智能体前进行过滤的 CLI 用户。
- 希望通过上下文压缩、聚焦分析和会话记忆降低上下文占用的高频编程智能体用户。
- 需要先用 --dry-run 预览配置改动，再决定是否写入本机智能体配置的谨慎采用者。
- 维护多操作系统开发环境，希望在 macOS、Linux 和 Windows 上采用同一套智能体工具链的团队。
如何安装或部署这个 Agent？
macOS 或 Linux：
curl -fsSL https://raw.githubusercontent.com/HoangP8/tokless/main/scripts/install.sh | bashWindows PowerShell：
irm https://raw.githubusercontent.com/HoangP8/tokless/main/scripts/install.ps1 | iex安装后运行 tokless 进入交互式选择，或运行 tokless --agents claude,opencode 仅配置指定客户端。来源未说明所需语言运行时、管理员权限或凭证；安装方式需要网络访问 GitHub 上的脚本和相关工具。安装完成后应重启目标智能体，使其载入新配置。
如何使用这个 Agent？
首次可运行：
tokless
它会安装工具并让你选择检测到的智能体，而且可以安全地重复运行。限定目标时可使用 tokless --agents claude,opencode，限定工具时可使用 tokless --tools rtk,caveman,ponytail,codegraph,context-mode。执行写入前可加 --dry-run，查看全部步骤可加 --verbose，跳过确认可加 --yes。使用 tokless index 为项目构建 codegraph 索引；使用 tokless doctor 检查接入状态；使用 tokless info 查看安装方式、路径和配置位置；使用 tokless update 更新 CLI 和工具。tokless disable 可停用一个或多个智能体，tokless uninstall 会移除 Tokless 写入的内容，tokless self-update 仅更新 CLI。
这个 Agent 有哪些优点和局限？
- 用一个跨平台 CLI 管理多种编程智能体的安装、更新、诊断、禁用和卸载流程。
- 为每种客户端采用其明确支持的 Hook、插件、扩展、指令或 MCP 接入方式，而不是要求所有客户端使用同一种机制。
- 集成的工具职责分开：rtk 过滤输出、codegraph 分析代码关系、context-mode 管理聚焦上下文，减少功能冲突。
- 提供 --dry-run、--verbose 和 tokless doctor，便于在写入前预览并在安装后排查配置。
- 支持 macOS、Linux 和 Windows，并允许只选择部分智能体或工具。
- 安装命令直接把从 GitHub 下载的脚本交给 Bash 或 PowerShell 执行，采用前需要自行评估远程脚本与其写入范围。
- 不同客户端的功能并不完全一致；Grok Build 明确不支持 RTK 命令重写。
- 安装后必须重启智能体才能载入配置，会打断正在进行的客户端会话。
- 来源没有说明语言运行时版本、权限要求、离线安装方法或网络失败后的恢复流程。
- 支持表列出 Kilo Code，但文档中的 --agents 可选值没有列出 kilo，命令行选择方式存在未解释的不一致。
这个 Agent 与同类方案有什么区别？
Tokless 不是 karpathy-skills、caveman、ponytail、rtk、codegraph 或 context-mode 的替代品，而是负责把这些现有组件组合并接入多个编程智能体。与逐个安装和手工协调这些组件相比，它提供统一的安装、更新、诊断与卸载入口；代价是各客户端仍受自身 Hook、插件、扩展和 MCP 能力限制。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|
| Tokless 当前 | 57 · 缺口较多 | ★ 274 | 11 天前 | Go | Codex · Claude Code |
| deepx-code | 63 · 存在缺口 | ★ 391 | 4 天前 | Go | OpenAI API |
| LeanCTX 上下文智能层 | 75 · 表现良好 | ★ 3.8k | 4 天前 | Rust | Codex · Claude Code · OpenAI API · Claude API |
| Tura | 65 · 存在缺口 | ★ 639 | 10 天前 | Rust | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 提供交互式选择、工具/代理子集、dry-run、verbose、disable 和 uninstall，体现了一定的最小化变更、确认和恢复设计；配置矩阵也概述了 Hook、MCP、Allow、Plugin 等外部影响。扣分在于推荐从 main 分支直接管道执行远程脚本，依赖使用 latest 且未固定或校验；未说明具体写入文件、网络数据流、遥测、凭据或其他敏感数据处理，也未展示备份和失败后恢复机制。依赖项目和许可证持有人有明确归属，但发布者身份仍未知，且第三方内容的供应链 provenance 不完整。
命令、工具列表和代理配置总体相互一致，CI 覆盖三种操作系统并执行测试和构建。扣分在于 go.mod 声明 Go 1.22、CI 使用 1.23，支持列表与 --agents 枚举也并非完全一致；context-mode 通过 npm 的 latest 安装且失败被忽略，缺少固定版本、可用性策略和降级说明。doctor 与 verbose 暗示诊断能力，但给定文件没有具体错误消息、退出行为或修复指引。
材料清楚面向希望快速统一配置编码代理的用户，列出多种代理、CLI/IDE/Desktop 场景、按代理和工具筛选的参数，并以 macOS、Linux、Windows CI 支撑环境适配，因此场景覆盖和环境适配较强。扣分在于能力边界主要靠配置表及一条 Grok/RTK 限制说明，未系统说明各工具不适用的任务、冲突规则或不同代理版本要求；触发方式虽明确，但缺少更细的选择语义和无参数交互边界。
README 的安装、工具、配置和使用结构清晰，命令示例充足；MIT 许可证完整，版本徽章、标签发布流程、自更新和版本差异提供了更新路径。扣分在于缺少 FAQ、故障排除、先决条件、独立变更日志和全面已知限制；Cursor/Kilo 等支持信息与参数枚举存在细小命名或覆盖不一致。维护责任仅可从仓库名称和版权主体推断，没有维护者联系、支持渠道、贡献政策或维护承诺。
统一安装、更新、检查、索引、禁用和卸载的命令接口可直接用于常见管理任务，配置矩阵也展示了把多个现有工具整合到多种代理中的增量价值。扣分在于没有运行结果、完整生成配置样例、性能数据或前后对照；“最佳工具”“零配置”“30 秒内”等效益声明缺少测量依据，安装多个 Hook、MCP 和全局 npm 工具带来的资源、维护及安全成本也未量化。
工具名称、用途、连接方式、平台 CI 和发布机制可追溯到 README 与工作流，部分跨文件事实（Go 项目、三平台构建、标签发布、MIT）能够相互印证。扣分在于核心效果和速度声明没有基准、测试结果或实现文件支持，且所给材料缺少安装脚本、应用代码和测试内容；营销性判断虽与具体配置大致分开，但没有明确标注哪些结论是实测、推断或主观选择。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 安装命令从 main 分支下载并立即执行远程 shell 或 PowerShell 脚本；使用前应固定到审查过的提交并验证内容或校验值。
- 第三方工具版本未固定，CI 还允许 context-mode 安装失败；不同时间安装可能得到不同依赖集合或缺失能力。
- 在启用 Hook、Allow、Plugin 和 MCP 配置前，应单独核查实际安装脚本、写入路径、网络访问、权限范围、凭据处理及卸载完整性。
- “30 秒内”“零配置”和“最佳工具”没有在所给文件中得到基准或测试结果支持。