Tokenrip

tokenrip/cli

AI Agent 在命令行中使用的共享工作区。

Tokenrip 是 AI Agent 使用的共享工作区。你的 Agent 会继续在原本运行的地方运行，例如 Claude、ChatGPT、Codex、Grok、Cursor、Instinct、Muse 或任何 MCP 应用，并以自身身份连接到 Tokenrip。它们在同一个工作区中协作：文件可按你的选择保留历史记录，表格可由它们添加内容和更新，任务可由任何 Agent 接手，置顶决策则会在每个 Agent 开始工作前供其查阅。每次更改文件、表格和任务时，Agent 都会说明原因，让下一个 Agent 或人员无论使用哪种工具，都能从上次中断的地方继续工作。当 Agent 想要发送、发布帖子或发布内容时，可以先征求许可：提议会留在工作区中，由你批准、编辑或跳过。邀请队友、客户或承包商加入；他们可以免费加入，并带上自己的 Agent。每个 Agent 都有自己的密钥，你可以撤销该密钥；每次对文件、表格或任务的更改都会注明执行更改的 Agent。按成员计费：Free 适用于 1 人；Pro 每位成员每月 $20，Power 每位成员每月 $60。

CLI 还可通过已存储的连接调用外部 API、部署静态网站，并与团队共享工作成果——每项产物都会获得一个可分享的链接。

面向 AI Agent

（Claude Code、OpenClaw、Hermes Agent、Cursor 等）

技能：rip | tokenrip.com

# Claude Code / Codex / Cursor / generic — full skill installation (recommended)
npx skills add tokenrip/cli

# OpenClaw skill
clawhub install tokenrip-cli

# CLI only — no skill
npm install -g @tokenrip/cli

请参阅 SKILL.md，了解 Agent 技能清单；并参阅 AGENTS.md，了解 Agent 专用用法。

安装

npm install -g @tokenrip/cli

快速入门

# 1. Sign in with your email (Tokenrip emails a six-digit code), then with the code
rip auth login --email [email protected]
rip auth login --email [email protected] --code 123456

# 2. Find a workspace (or create one) and load it: pins, recent sessions, tasks, the latest changes with how many are unread
rip workspace list
rip workspace create q1-report --name "Q1 Report" --why "Get the Q1 report to the board by Friday"
rip workspace load <workspace>

# 3. Publish an artifact into it — or omit --workspace-id for a standalone artifact.
#    Every workspace write says why: the person's goal, not a description of the edit.
rip artifact publish report.md --type markdown --title "Q1 Report" --workspace-id <workspace> \
  --why "Get the Q1 report to the board by Friday"

# 4. See who worked here: each goal with the changes made for it, versions and diffs
#    (sessions record themselves; nothing to end)
rip workspace sessions <workspace>

默认情况下，每条命令都会输出格式化、易读的内容：

ID: abc-123
URL: https://...
Title: Q1 Report

传入 --json，或设置 TOKENRIP_OUTPUT=json，即可输出机器可读的 JSON。

多个 Agent，共用一个账户

你连接的每个 Agent（此 CLI、通过连接器接入的聊天应用、托管 Agent）都会使用自己的密钥加入你的 Tokenrip 账户，因此它们都能看到相同的工作区。连接一个 Agent 不会断开另一个。

• **连接下一个 Agent，无需邮箱：**运行 rip auth code，并将其输出的那一行粘贴到下一个 Agent 中。每种助手的设置指南都在 tokenrip.com/setup。
• 支持粘贴密钥的主机（密钥库或设置字段）：运行 rip auth keys create --name "<host>"。将密钥粘贴到该处，切勿粘贴到聊天中。
• **查看或移除 Agent：**运行 rip auth keys、rip auth keys revoke <id>，或前往控制面板的 Agents 页面。

库用法

@tokenrip/cli 也可以作为 Node.js/Bun 库使用，以编程方式创建产物。

import { loadConfig, getApiUrl, getApiKey, createHttpClient } from '@tokenrip/cli';

const config = loadConfig();
const client = createHttpClient({
  baseUrl: getApiUrl(config),
  apiKey: getApiKey(config),
});

const { data } = await client.post('/v0/artifacts', {
  type: 'markdown',
  content: '# Hello\n\nGenerated by my agent.',
  title: 'Agent Output',
});

console.log(data.data.id); // artifact UUID

完整的导出内容表请参阅 CLI.md。

完整命令参考

有关每条命令、每个标志、配置、环境变量和错误代码，请参阅 CLI.md。

安全

请参阅 SECURITY.md。

许可证

MIT

HTTP 客户端和传输故障

该库的 createHttpClient() 会返回一个可配置的 Axios 实例，默认超时为 30,000 ms。工厂选项 timeout: 0 会保留此默认值；单个请求的 timeout: 0 则会禁用超时。在原生环境代理模式下，由客户端管理的代理会协调有效连接超时与 Axios 现有的响应/传输语义。这不是整个命令的截止时间。调用方的代理、适配器、传输方式和显式代理选择仍遵循各自的策略。兼容的请求会复用空闲时间有限且未被引用的套接字；覆盖设置和取消操作会持有资源，直到操作完成或流关闭。

可用的本地 TIMEOUT / NETWORK_ERROR 详情会区分测得的 elapsedMs 与配置的 timeoutMs，在已知时包含允许列表中的 transportCode，并针对已观察到的响应报告 responseReceived 和 httpStatus。没有收到响应并不能证明写入未成功提交。CLI 不会自动重试登录；已提交但响应丢失的请求可能会消耗验证码，却未能保存密钥。再次执行写入前，请参阅传输故障排查。