Provides a shared workspace for AI agents to synchronize files, tasks, decisions, and handoffs across different platforms.
Also known as tokenrip/cli, cli, @tokenrip/cli
- Stars
- 6
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.1.0
- Last commit
- Nov 14, 2026
- License
- MIT
What is Tokenrip MCP?
Tokenrip provides a shared workspace for AI agents to synchronize files, tasks, decisions, and handoffs across different platforms.
Summary generated from the project's README
About Tokenrip MCP server
Tokenrip provides a centralized workspace designed for AI agents to synchronize their work across various platforms. It allows agents running in tools like Claude, ChatGPT, Cursor, or Grok to share files, update tables, manage tasks, and read pinned decisions. This ensures that when one agent finishes a task, the next one can pick up exactly where the previous session left off by reviewing the stated reasoning behind every change.
Users interact with the service via a command line interface or by adding it as a skill to specific agents using commands like npx skills add tokenrip/cli. The system manages multiple agents under a single account, assigning each its own unique key that can be individually revoked. It supports collaborative environments where teammates or contractors can join a workspace to bring their own agents. The service offers different pricing tiers including Free, Pro, and Power based on the number of members.
What you can do with it
- 1Synchronize multi-agent workflowsHand an AI agent a task to update a shared table and ensure the next agent understands the context.
- 2Review and approve agent proposalsAsk an AI agent to draft a post or publication and wait for human approval in the workspace.
- 3Manage agent access securityCreate unique credentials for different AI tools and revoke them if they are no longer needed.
- 4Deploy web content from the CLIInstruct an agent to use the command line to deploy static sites or share artifacts via links.
Written from the project's README. Every use case is checked against a quote from it.
How to install Tokenrip MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Tokenrip MCP in Claude Code
$ claude mcp add cli -- npx -y @tokenrip/cliInstall Tokenrip MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@tokenrip/cli"
]
}
}
}Install Tokenrip MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tokenrip/cli"
]
}
}
}Install Tokenrip MCP in VS Code CLI
$ code --add-mcp '{"name":"cli","type":"stdio","command":"npx","args":["-y","@tokenrip/cli"]}'Install Tokenrip MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@tokenrip/cli"
]
}
}
}Install Tokenrip MCP in Codex
$ codex mcp add cli -- npx -y @tokenrip/cliInstall Tokenrip MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cli] command = "npx" args = ["-y", "@tokenrip/cli"]
Install Tokenrip MCP in Gemini CLI
$ gemini mcp add -s user cli npx -- -y @tokenrip/cliInstall Tokenrip MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@tokenrip/cli"
]
}
}
}Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubtokenrip/cli
The shared workspace your AI agents work from, on the command line.
Tokenrip is the shared workspace your AI agents work from. Your agents keep running where they already do, in Claude, ChatGPT, Codex, Grok, Cursor, Instinct, Muse or any MCP app, and connect to Tokenrip as themselves. They work from one workspace: files that keep as much history as you choose, tables they add to and update, tasks any agent can pick up, and pinned decisions every agent reads before it starts. Agents state why on every change to files, tables and tasks, so the next agent or person picks up where the last one left off, whichever tool it ran in. When an agent wants to send, post or publish something, it can ask first: the proposal waits in the workspace, and you approve it, edit it or skip it. Invite teammates, clients or contractors; they join free and bring their own agents. Each agent has its own key you can revoke, and every change to a file, table or task names the agent that made it. Pricing is per member: Free is for one person; Pro is $20 and Power $60 per member a month.
The CLI also calls external APIs through stored connections, deploys static sites, and shares work with teams — every artifact gets a shareable link.
For AI Agents
(Claude Code, OpenClaw, Hermes Agent, Cursor, etc.)
Skill:
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
See SKILL.md for the agent skill manifest and AGENTS.md for agent-specific usage.
Install
npm install -g @tokenrip/cli
Quick start
# 1. Sign in with your email (Tokenrip emails a six-digit code), then with the code
rip auth login --email you@example.com
rip auth login --email you@example.com --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>
Every command outputs formatted human-readable output by default:
ID: abc-123
URL: https://...
Title: Q1 Report
Pass --json or set TOKENRIP_OUTPUT=json for machine-readable JSON output.
Several agents, one account
Every agent you connect (this CLI, a chat app through a connector, a hosted agent) joins your one Tokenrip account with its own key. A new key can use every workspace you can, unless it is created limited, and you can limit an existing key on the Agents page. Connecting one never disconnects another.
- Next agent, no email: run
rip auth codeand paste the line it prints into the next agent. The setup guide for every kind of assistant is at tokenrip.com/setup. - A host that takes a pasted key (a key vault or settings field):
rip auth keys create --name "<host>". Paste the key there, never into a chat. - See or remove agents:
rip auth keys,rip auth keys revoke <id>, or the dashboard's Agents page.
Library usage
@tokenrip/cli also works as a Node.js/Bun library for programmatic artifact creation.
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
See CLI.md for the full exports table.
Full command reference
See CLI.md for every command, every flag, configuration, environment variables, and error codes.
Security
See SECURITY.md to report a vulnerability in the CLI, and tokenrip.com/security for how Tokenrip protects your data.
License
MIT
HTTP client and transport failures
The library's createHttpClient() returns a configurable Axios instance with a 30,000 ms default. Factory timeout: 0 retains that default; per-request timeout: 0 disables the timeout. In native environment-proxy mode, client-owned agents coordinate the effective connection timeout with existing Axios response/transfer semantics. This is not a whole-command deadline. Caller agents, adapters, transports and explicit proxy choices retain their policy. Compatible requests reuse finitely idle, unreferenced sockets; overrides and cancellation own resources until completion or stream closure.
Available local TIMEOUT / NETWORK_ERROR details distinguish measured elapsedMs from configured timeoutMs, include an allowlisted transportCode when known, and report responseReceived plus httpStatus for observed replies. No response does not prove a write failed to commit. The CLI never retries sign-in automatically; a committed lost response can consume a code without saving its key. See transport troubleshooting before repeating a write.
Tokenrip MCP questions
How do I add Tokenrip MCP to Claude Code?
Run claude mcp add cli -- npx -y @tokenrip/cli in your terminal. Add --scope user to make it available in every project.
How do I add Tokenrip MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do different AI agents use the same workspace?
Agents connect to Tokenrip as themselves, allowing them to share files, tables, tasks, and pinned decisions regardless of whether they run in Claude, ChatGPT, or Cursor.
How does Tokenrip handle agent handoffs?
Agents state the reason for every change made to files, tables, or tasks, ensuring the next agent or person understands the context.
What are the pricing tiers?
Pricing is based on members: Free is for one person, Pro is $20 per member per month, and Power is $60 per member per month.