Tokenless API CLI

Tokenless Web Harness 的 CLI 与本地 API 入口，让你已有的网页大模型账号为 Agent 完成任务。

English · 命令参考 · Capability Matrix · 隐私

三种使用方式

| 用法 | 由谁执行任务流程 | | --- | --- | | Tokenless Harness + API | Tokenless Harness 管理任务，通过 Tokenless API 访问网页大模型。 | | 自选 Harness + Tokenless API | 自己的 Harness 保留工具与流程，使用 Tokenless API 作为模型接口。 | | 自选 Harness + Tokenless Skill | 在原有工作流中按需调用 Skill，只交出选定任务。 |

查看 Dashboard 与三种用法图示。

Provider 清单

当前目录共 40 个 provider：18 个浏览器条目，其中 16 个有任务路由，以及 22 个仅 Direct 模式的条目。

• 已支持的浏览器路由：ChatGPT、Claude、Gemini、Grok、Arena。
• 实验性浏览器路由：Qwen / 千问、DeepSeek、Perplexity、Z.ai / GLM、Doubao / 豆包、Kimi、Dola、Meta AI、GitHub Copilot、Lovable、Monica。
• 尚无任务路由的浏览器条目：Microsoft Copilot、HuggingChat。

以下为实验性 G4F 映射；目录登记不等于已通过逐项真实运行验证。另有 13 个浏览器 provider 也注册了 Direct 入口，共 35 个 Direct 映射。

| Provider | ID | Provider | ID | | --- | --- | --- | --- | | Black Forest Labs | black-forest-labs | Cerebras | cerebras | | Cloudflare AI | cloudflare | Cohere | cohere | | DeepInfra | deepinfra | ElevenLabs | elevenlabs | | Groq | groq | MiniMax | minimax | | NVIDIA | nvidia | Ollama | ollama | | OpenRouter | openrouter | Opera Aria | opera-aria | | Phind AI | phind | Pi | pi | | Pollinations | pollinations | Replicate | replicate | | Sber GigaChat | gigachat | Stability AI | stability-ai | | Teach Anything | teach-anything | Together AI | together | | WhiteRabbitNeo | whiterabbitneo | YQCloud | yqcloud |

完整清单、模式与支持范围。

安装

Browser 功能需要 Node.js 22.13+，以及能提供浏览器自主管理 remote debugging endpoint 的当前版 Google Chrome 或 Brave Browser。Apple Silicon macOS 是当前主要 target；Windows x64 仍处于 prerelease。

Chrome 与 Brave 必须由用户自行提供；Tokenless 不会 bundle 或下载它们。Setup 找不到所选浏览器时仍会保存配置、跳过 provider 检查，并在结束时提示如何添加 executable path。首次 browser action 会验证该 path，或再次尝试标准 discovery。在 setup 过程中，CloakBrowser 是 Tokenless 唯一会下载并准备的 browser runtime。

npm install --global tokenless@latest
tokenless setup
tokenless doctor --json

Setup 需要 uv 来准备 G4F runtime，并会自动同步配套 skills；升级也会同步。仅刷新 skills 可运行 tokenless skills sync --json。Windows 不安装 macOS 菜单栏 App，macOS 的菜单栏 App 为独立可选安装。

在使用 browser 功能前，请在日常使用的 Google Chrome 中打开 chrome://inspect/#remote-debugging，或在 Brave 中打开 brave://inspect/#remote-debugging，启用 remote debugging，并在浏览器出现提示时确认连接。

Setup 会先询问是否使用 Anti-Detect mode，再让 native-mode 用户选择 Chrome 或 Brave。Browser discovery 失败时 setup 仍会完成并提示添加 executable path；在 browser access 可用前不会运行 provider 检查。

如需非交互式 setup：

tokenless setup --defaults --json

Setup 会创建或复用命名的逻辑 profile，并使用其持久化的 profiles[slug].enabledProviders。交互式 setup 可按编号移除 provider。

可选 Codex 集成

tokenless agents install codex

重启 Codex，在 /hooks 中信任 Tokenless definition，然后继续正常启动 Codex。Tokenless 不提供 Codex wrapper、relay 或自定义 model provider；它只添加可逆的全局 guidance 与 native hooks，用于绑定精确 chat、turn、tool call、本地 project 和 provider conversation。

使用 tokenless agents status codex --json、tokenless agents inspect codex --chat-id <codex-thread-id> --json 和 tokenless agents uninstall codex 进行检查与移除。Harness ledger 只保存有界 ID 与 hash，不保存原始 prompt、transcript、credential 或 browser state。

Codex hooks 不会替换 native subagent execution。Codex workflow 需要显式委托 Tokenless Harness-owned child 时，请使用 tokenless agent delegate --workspace-root "$PWD" ...。

使用 internal Codex sub-agent 不会隐藏 Codex UI delegation messages；Tokenless 不能控制 Codex UI，也不能控制 native spawn_agent 的行为。只有在用户明确要求 separate tasks，或明确需要 independently visible progress 时，sidebar-visible 的 worker/reviewer 工作才使用 separate Codex tasks；主 task 读取 status 并给出简短 synthesis。不要重复粘贴长 child report：报告只包含 child name、status、at most one blocker 和 coordinator decision。

DeepSeek Harness Subagent 集成

tokenless agents install dsh --provider chatgpt --profile default --dsh-profile headless --json

该命令注册一个 DeepSeek Harness SubagentProvider，并把它的普通 one-shot subagent tool 路由到 Tokenless Harness。它与 model base URL 路径彼此独立；后者继续使用 DeepSeek Harness 现有的 llm-deepseek adapter。

运行

tokenless run \
  --profile default \
  --provider chatgpt \
  --prompt "Review this proposal." \
  --json

使用 setup 管理的 GPT4Free backend 完成一次 ChatGPT direct 文本聊天：

tokenless run \
  --profile default \
  --provider chatgpt \
  --execution-mode direct \
  --provider-backend g4f \
  --prompt "Review this proposal." \
  --json

使用 --provider-backend native 可保留现有 Tokenless ChatGPT 或 Perplexity 实现，用于 A/B 测试和回切。

Setup 会安装一个固定版本的私有 g4f[all] Python service。Tokenless 继续拥有 browser control 与 profile；G4F 在 authenticated daemon API 后处理 direct provider HTTP、impersonation、Sentinel/PoW、streaming、HAR/Cookie auth 与 media。不传 --execution-mode direct 时保持 visible-browser 行为。

Backend flag、标准 API route、provider mapping、版本固定与隔离边界见 GPT4Free direct provider service。

如未显式指定 provider，Tokenless 会使用第一个已配置且有 guest 或 signed-in 观测的 provider；没有可用项时会在创建 job 前失败。

使用 tokenless capabilities list --json 查看有证据支持的 task outcome 与 provider route。--capability 可重复提供；附件会推导 file.upload 与 MIME 对应的 semantic input（非媒体文件为 document.input，图片、音频、视频分别为匹配的 image.input、audio.input、video.input），workspace intent 也会推导 capability；一个 provider 必须满足合并后的全部要求。

tokenless run \
  --capability file.upload \
  --attach-file proposal.pdf \
  --prompt "Review the attached proposal." \
  --json

普通隐式路由会为当前 execution 保留兼容的 provider alternatives。在 prompt 提交前遇到 auth、CAPTCHA、capacity 或 plan blocker 时，会立即尝试下一个满足完整 capability 的 provider；显式 provider、精确 continuation 和不可重建操作会 fail closed。

Providers

| Provider | 阶段 | 未登录使用 | | --- | --- | --- | | ChatGPT | 已支持 | 支持 guest | | Claude | 已支持 | 需要登录 | | Gemini | 已支持 | 支持 guest | | Grok | 已支持 | 需要登录 | | Qwen / 千问 | 实验性 | 支持 guest | | DeepSeek | 实验性 | 需要登录 | | Perplexity | 实验性 | 支持 guest | | Z.ai / GLM | 实验性 | 支持 guest | | Doubao / 豆包 | 实验性 | 需要登录 | | Kimi | 实验性 | 需要登录 | | Dola | 实验性 | 需要登录 | | Arena | 已支持 | 需要登录 | | Meta AI | 实验性 | 需要登录 | | GitHub Copilot | 实验性 | 需要登录 |

Prompt 提交与 response 读取是共同 baseline。File、citation、model/effort control、continuation 和 Workspace 支持取决于 provider、profile 和 account state。Meta AI 的 chat 与 file upload 已可从选定的登录 profile 实验性路由，并支持 Instant/Thinking 选择；在 CLI 暴露图片 artifact lifecycle 前，image generation 仍不公开。

GitHub Copilot 控制：Ask / Agent、repository / Project、模型权限、文件与 AI credits。

Qwen Modes

Qwen 通过 qwen.mode.inspect 和 qwen.mode.select 暴露 provider-specific mode：

tokenless run --provider qwen --qwen-mode "Deep Research" --qwen-mode-variant "Advanced" --prompt "Proceed with a standalone report." --json

当前实验性 capability 证明精确 mode selection 和第一个关联的可见 response，尚不声称完整的多轮最终报告 lifecycle。

Doubao Modes 与 Skills

Doubao 通过 doubao.mode.inspect/select 和 doubao.skill.inspect/select 暴露精确 controls。稳定的英文 action payload 选择中文可见 label，每次选择都需要可见 selected-state postcondition。完整 generation/research lifecycle 通过独立 real-provider gate 前仍为 candidate。

Workspaces

如未提供 --workspace-mode，--project-name 仅是 task metadata。

• auto 优先使用已证明的 native Project，只在可见证据表明不可用时 fallback。
• native 需要精确创建或复用 native Project。
• conversation 需要 conversation strategy。

Claude 和 Grok 的 native Project 行为已有实验性 gate，但在完整 gate 通过前不会将 workspace.native 广告为 router route。

Managed Profiles

一个 managed profile 可保持所有已启用 provider 的 session。如需同一 provider 的多个 account，请使用不同 profile。

tokenless profiles list --json
tokenless profiles open --profile work
tokenless profiles open --profile work --provider claude
tokenless profiles status --profile work --provider claude --json

Tokenless profile 只组织 provider tab 与配置，不创建独立 browser identity。当前已发布的 visible-browser mode 不检查单个 cookie、token、browser storage、Keychain data 或 authentication value；任何 mode 都不会把这些值暴露给 agent。

Managed runtime 会把不同 provider 和稳定的 task identity 保持在独立 tab 中。重新进入相同 project 或 conversation task 会返回原来的 tab；替换它需要通过 local job API 显式设置 pagePolicy: replace。

Page Ref 是地址，不是执行锁：Tokenless API 允许并发使用同一 profile 和 Page Ref，conversation 顺序由 Tokenless Harness 控制。完整读取回答后，自有工作标签页可进入空闲回收，具体限制见下文。

Browser 与本地 Runtime

Tokenless API 每 15 秒检查一次，回收连续空闲 120 秒的自有工作标签页。每个 profile 最多 8 个工作标签页：达到上限时提前回收最早空闲的页面；全部忙碌或保留时拒绝新建页面。

• 活跃任务、生成、未发送草稿、上传及无法确认状态的页面保持保护。保留中的工作页会持续复查，确认完成后可重新进入 idle。显式打开的用户页面仍不参与回收。
• 再次使用空闲页会重置计时。回收后，以相同 task ID（未提供时使用 Page Ref）正常续聊，会重新打开已保存的 provider 对话链接。
• 在 System 或持久化 config.json 中设置 browserTabGc：idleTimeoutSeconds、sweepIntervalSeconds。活跃工作标签页没有数量上限。System 显示 busy/idle 数量和回收计数；计数随 daemon 重启清零。

回收器运行在 daemon 内，适用于 headed 和 headless 托管 context。它关闭标签页、保留常驻浏览器，不删除对话历史。所有已运行的注册 profile 都会自动接管，无需启动或重启浏览器。本地 target ID 归属文件让工作页在 daemon 重启后恢复监管；旧页面只有在完整 URL 匹配持久化任务对话时才接回。回答或用户活动变化会重置 idle 计时。System 显示浏览器实际页面数、未接管 / 用户页面数及 profile 连接失败；无法确认的页面保留并计入清单。

Native mode 只支持 headed，因为它控制用户已打开的 Chrome 或 Brave。停止或重启 daemon 只会断开 Playwright，不会关闭所选浏览器。

每个 visible-browser 请求都使用经过认证的 loopback daemon 和所选浏览器中的 Tokenless-owned tab。Provider 凭据绝不会暴露给 agent；登录、CAPTCHA、付款、plan 以及含义不明确或涉及外部授权的确认始终由用户控制。对于用户已选择的 provider，provider adapter 可以接受内容明确且已知的 onboarding Terms/Privacy 对话框。

所有命令和 option 见命令参考；完整 capability 语义见 Capability Matrix。