Tokless
在多个编程智能体中统一安装代码分析、上下文压缩与精简指令工具。
- Star 数
- ★ 362
- 最近更新
- 今天
- License
- MIT
- 主语言
- Go
- FA 评分
- 57/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时使用 Claude Code、Codex 或其他受支持客户端,希望用一个命令保持工具与指令配置一致的开发者。
- 不适合
- 需要完全离线安装的团队:安装脚本从 GitHub 拉取并直接执行
- 使用 Grok Build 且依赖 RTK 命令重写的用户
- 无法接受安装后重启客户端会话的团队
- 源码审查
- 57/100 · 缺口较多
这个 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 · 缺口较多 | 命令行工具免费 | ★ 362 | 今天 | Go | Codex · Claude Code |
| deepx-code | 53 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 391 | 1 个月前 | Go | OpenAI API |
| LeanCTX 上下文智能层 | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 3.9k | 今天 | Rust | Codex · Claude Code · OpenAI API · Claude API |
| Tura | 62 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 664 | 1 个月前 | Rust | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
提供 --dry-run、按 harness/tool 限定范围、交互式选择 harness、保留外部配置以及检测到用户改动时拒绝覆盖,并说明 Headroom 的本地代理路径和 OAuth/BYOK 配置处理;这些支持有限权限和可回退性。扣分原因:安装示例使用 curl/irm 管道执行远程脚本,代理默认开机启动,且提示 Linux 保持 enable-linger;材料没有说明密钥在代理中的具体存储、传输保护或权限隔离。依赖安全检查也较薄,CI 会尝试安装 @latest,且失败被 || true 忽略。
README、安装文档与 CLI 帮助大体一致,CLI 对无效参数给出允许值或用法错误,doctor 可报告健康状态和警告。扣分原因:文档列出 8 个工具、16 个 harness,而 CLI 实际列出 17 个 harness;CI 中外部工具安装失败会被忽略,且材料未呈现依赖版本锁定、可用性处理细节。
明确面向多种编码 harness,覆盖 macOS、Linux、Windows,并提供按 harness 和工具选择、代理配置、离线相关 CLI 标志及多种配置位置。扣分原因:标榜任何 OS 和 30 秒零配置,但未展示所有 harness 的具体兼容边界或离线安装流程;代理和自动启动的默认行为对不同环境可能有差异。
README 按安装、工具、配置、使用和 harness 配置位置组织,安装文档给出步骤、命令、预览、健康检查与代理撤销说明;许可证文件为 MIT。扣分原因:README 与 CLI 的 harness 数量不一致,版本演进和变更记录在所给材料中不足,维护责任只可从仓库名和工作流部分推断,未明确维护承诺。
产品把规则、命令输出压缩、代码索引、上下文工具和项目记忆集成到一个 CLI,并声称将 MCP 工具从 27 个筛为 10 个;命令示例和管理入口较具体。扣分原因:压缩、索引、记忆和节省 token 的效益主要是产品自述,未有结果数据或独立佐证;自动代理和多种集成的运行成本也未量化。
不少功能主张对应到具体工具名、端口、配置路径、命令和代理行为,CI 文件展示了构建与测试工作流。扣分原因:给定材料没有测试结果或针对 README 兼容性表的逐项佐证;CI 对部分外部依赖安装失败容忍,且营销性效益主张未与推断清楚分开。
- 安装命令会执行从远程地址获取的脚本;安装前应审阅脚本,并在配置前用 --dry-run 检查写入范围。
- Headroom 默认设置开机启动;文档说明 Linux 会保留 enable-linger。需要了解代理和登录启动行为后再启用。
- README 与 CLI 对 harness 数量存在差异;应以实际 CLI 的有效 ID 和 doctor 报告为准。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's Changed * chore: readme badge colors by @HoangP8 in https://github.com/HoangP8/tokless/pull/59 * fix: Defender false-positive handling and rollback (#60) by @HoangP8 in https://github.com/HoangP8/tokless/pull/61 Full Changelog: https://github.com/HoangP8/tokless/compare/v1.0.11...v1.0.12在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * fix(context-mode): support context-mode 2.x (#56) by @HoangP8 in https://github.com/HoangP8/tokless/pull/58 Full Changelog: https://github.com/HoangP8/tokless/compare/v1.0.10...v1.0.11在 GitHub 查看 ↗
常见问题
需要 API 密钥或付费模型订阅吗?
安装程序会修改什么?
能否只配置一个智能体或一部分工具?
安装损坏或配置失效时怎么办?
所有受支持客户端都有完整的相同功能吗?
谢谢反馈,我们会据此改进页面。