Tokless

在多个编程智能体中统一安装代码分析、上下文压缩与精简指令工具。

Star 数
★ 362
最近更新
今天
License
MIT
主语言
Go

30 秒速览

运行形态
命令行工具
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Shell / 命令行网络访问本地文件系统MCP Server
典型场景
同时使用 Claude Code、Codex 或其他受支持客户端,希望用一个命令保持工具与指令配置一致的开发者。
不适合
  • 需要完全离线安装的团队:安装脚本从 GitHub 拉取并直接执行
  • 使用 Grok Build 且依赖 RTK 命令重写的用户
  • 无法接受安装后重启客户端会话的团队

这个 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、显示版本差异并升级工具。

  1. 同时使用 Claude Code、Codex 或其他受支持客户端,希望用一个命令保持工具与指令配置一致的开发者。
  2. 需要为大型代码库建立代码图,以便查看源码关系、调用路径和修改影响的团队。
  3. 经常遇到终端输出挤占上下文窗口,希望在输出进入编程智能体前进行过滤的 CLI 用户。
  4. 希望通过上下文压缩、聚焦分析和会话记忆降低上下文占用的高频编程智能体用户。
  5. 需要先用 --dry-run 预览配置改动,再决定是否写入本机智能体配置的谨慎采用者。
  6. 维护多操作系统开发环境,希望在 macOS、Linux 和 Windows 上采用同一套智能体工具链的团队。

如何安装或部署这个 Agent?

macOS 或 Linux:

curl -fsSL https://raw.githubusercontent.com/HoangP8/tokless/main/scripts/install.sh | bash

Windows 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
57/ 100 五分制 2.9 / 5
信任安全 14/29
可靠稳定 6/14
适用触发 14/18
规范维护 12/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

提供 --dry-run、按 harness/tool 限定范围、交互式选择 harness、保留外部配置以及检测到用户改动时拒绝覆盖,并说明 Headroom 的本地代理路径和 OAuth/BYOK 配置处理;这些支持有限权限和可回退性。扣分原因:安装示例使用 curl/irm 管道执行远程脚本,代理默认开机启动,且提示 Linux 保持 enable-linger;材料没有说明密钥在代理中的具体存储、传输保护或权限隔离。依赖安全检查也较薄,CI 会尝试安装 @latest,且失败被 || true 忽略。

可靠稳定6 / 14 · 2.1/5

README、安装文档与 CLI 帮助大体一致,CLI 对无效参数给出允许值或用法错误,doctor 可报告健康状态和警告。扣分原因:文档列出 8 个工具、16 个 harness,而 CLI 实际列出 17 个 harness;CI 中外部工具安装失败会被忽略,且材料未呈现依赖版本锁定、可用性处理细节。

适用触发14 / 18 · 3.9/5

明确面向多种编码 harness,覆盖 macOS、Linux、Windows,并提供按 harness 和工具选择、代理配置、离线相关 CLI 标志及多种配置位置。扣分原因:标榜任何 OS 和 30 秒零配置,但未展示所有 harness 的具体兼容边界或离线安装流程;代理和自动启动的默认行为对不同环境可能有差异。

规范维护12 / 18 · 3.3/5

README 按安装、工具、配置、使用和 harness 配置位置组织,安装文档给出步骤、命令、预览、健康检查与代理撤销说明;许可证文件为 MIT。扣分原因:README 与 CLI 的 harness 数量不一致,版本演进和变更记录在所给材料中不足,维护责任只可从仓库名和工作流部分推断,未明确维护承诺。

有效结果7 / 13 · 2.7/5

产品把规则、命令输出压缩、代码索引、上下文工具和项目记忆集成到一个 CLI,并声称将 MCP 工具从 27 个筛为 10 个;命令示例和管理入口较具体。扣分原因:压缩、索引、记忆和节省 token 的效益主要是产品自述,未有结果数据或独立佐证;自动代理和多种集成的运行成本也未量化。

证据核验4 / 8 · 2.5/5

不少功能主张对应到具体工具名、端口、配置路径、命令和代理行为,CI 文件展示了构建与测试工作流。扣分原因:给定材料没有测试结果或针对 README 兼容性表的逐项佐证;CI 对部分外部依赖安装失败容忍,且营销性效益主张未与推断清楚分开。

风险与缓解建议
  • 安装命令会执行从远程地址获取的脚本;安装前应审阅脚本,并在配置前用 --dry-run 检查写入范围。
  • Headroom 默认设置开机启动;文档说明 Linux 会保留 enable-linger。需要了解代理和登录启动行为后再启用。
  • README 与 CLI 对 harness 数量存在差异;应以实际 CLI 的有效 ID 和 doctor 报告为准。
证据充分度:低 评估于 2026年11月8日 审查版本 e95f306d0d3d
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/tokless.svg?lang=zh)](https://followagents.com/zh/agents/tokless)
<a href="https://followagents.com/zh/agents/tokless"><img src="https://followagents.com/badge/tokless.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v1.0.12
    发布说明摘录
    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 查看 ↗
  2. v1.0.11
    发布说明摘录
    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 查看 ↗
  3. v1.0.10
    发布说明摘录
    Full Changelog: https://github.com/HoangP8/tokless/compare/v1.0.9...v1.0.10
    在 GitHub 查看 ↗

常见问题

需要 API 密钥或付费模型订阅吗?
来源没有记录 Tokless 自身需要 API 密钥,也没有说明各编程智能体或底层模型的费用与订阅要求。
安装程序会修改什么?
它会按目标智能体接入指令、Hook、Allow 规则、插件、扩展或 MCP 配置,并可建立逐项目的 codegraph 索引。来源没有逐项列出所有被修改文件;可先用 --dry-run 预览,并用 tokless info 查看路径与配置位置。
能否只配置一个智能体或一部分工具?
可以。使用 --agents <list> 限定客户端,使用 --tools <list> 限定 rtk、caveman、ponytail、codegraph 或 context-mode。
安装损坏或配置失效时怎么办?
运行 tokless doctor 查看已接入项目并获得损坏项警告;tokless update 可更新 CLI 和工具。来源没有给出更细的自动修复保证。
所有受支持客户端都有完整的相同功能吗?
没有。接入机制随客户端变化,部分使用 Hook、插件或扩展;Grok Build 明确不支持 RTK 命令重写。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。