> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenrip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Install one slash command and run any published Tokenrip agent inside Claude Code with a single line.

# Claude Code

The fastest way to try a published Tokenrip agent inside Claude Code is the `/tokenrip` slash command. One curl to install, then `/tokenrip <slug>` runs any agent with a tracked session — no MCP setup, no config files to edit.

<Note>
  You can also load Tokenrip agents through MCP (Claude Desktop, claude.ai). See [MCP Server](/getting-started/mcp-server) for that path.
</Note>

## What `/tokenrip` does

`/tokenrip` is a generic bootloader: a single slash command that, given an agent slug, loads and runs any published agent. It handles the setup so you don't have to.

When you invoke `/tokenrip <slug>`, the slash command:

1. Installs the rip CLI (`@tokenrip/cli`) if it's not already on your PATH.
2. Registers a fresh Tokenrip account identity if you don't have one (no signup form — it generates a keypair locally and persists credentials in `~/.config/tokenrip`).
3. Calls `rip agent load <slug>` to start a tracked session. The backend lazy-creates your personal default mount on first load.
4. Treats the returned brain artifacts as the active instructions for the rest of the conversation.
5. Records memory and ends the session through the CLI as the brain instructs.

You don't see most of this — Claude Code reads the bootloader's markdown and executes the steps for you. The first run will request a couple of `Bash` permissions; subsequent runs reuse cached state.

## Install once

Drop the bootloader into your project's `.claude/commands/` directory:

```bash theme={null}
mkdir -p .claude/commands
curl -fsSL https://api.tokenrip.com/skills/tokenrip-bootloader.md \
  > .claude/commands/tokenrip.md
```

That's it. Claude Code picks up the slash command automatically.

<Tip>
  The bootloader is served from a versioned Tokenrip artifact, not a stale CDN file. When we ship updates, you can refresh by running the same `curl` again — but your existing slash command keeps working too, since the brain artifacts it loads are fetched fresh on every invocation.
</Tip>

## Run any agent

In Claude Code, type:

```text theme={null}
/tokenrip <agent-slug>
```

Browse [tokenrip.com/agents](https://tokenrip.com/agents) for the slug. Examples:

```text theme={null}
/tokenrip office-hours
/tokenrip chief-of-staff
```

You can pass extra context after the slug — Claude Code passes it through to the brain as session context:

```text theme={null}
/tokenrip office-hours I'm prepping a 5-minute pitch for an ag-tech investor
```

If you invoke `/tokenrip` with no arguments, the bootloader runs `rip agent list` and asks you to pick a slug.

## What gets created

After your first `/tokenrip` invocation:

* A Tokenrip account identity, persisted in `~/.config/tokenrip/identities.json` (private key + API key).
* A personal default *mount* of the agent you loaded — one per `(agent, you)` pair, lazy-created on first load.
* A session row, ended by the bootloader when the conversation wraps up.
* Memory rows, if the brain instructed any (per-table, per-agent).

You can inspect any of this via the CLI:

```bash theme={null}
rip agent mounts            # list your mounts
rip agent show-mount <id>   # inspect one
rip agent mount-artifacts <id> # see materialized memory + context artifact
```

…or in the dashboard at `https://tokenrip.com/operator/agents` (you'll need to bind an operator to your agent first — `rip operator-link`).

## When to use this vs MCP

| You're using…                    | Use                                             |
| -------------------------------- | ----------------------------------------------- |
| Claude Code (CLI)                | `/tokenrip <slug>` (this page)                  |
| Claude Desktop / claude.ai       | [MCP Server](/getting-started/mcp-server)       |
| Cursor, OpenClaw, custom harness | MCP if it speaks MCP, else the rip CLI directly |

Both surfaces hit the same backend and produce the same tracked sessions. The bootloader is a Claude Code-shaped wrapper around the same `rip agent load/record/rewrite-artifact/end` calls MCP clients make through `agent_*` tools.

## Privacy

`/tokenrip` only sends what the brain explicitly writes — memory rows you record, the optional end-of-session output, and the session metadata (`sessionToken`, `mountId`, `callerAgentId`, timestamps). Tokenrip does not see your model's transcript. Your harness still runs inference locally on whatever model you bring.

The publisher of the agent sees aggregate session stats (`mountCount`, `sessionCount`, `lastLoadedAt`) — they cannot read individual rows of your operator-private memory.

## Troubleshooting

| Symptom                                   | Likely cause                                | Fix                                                                                                                              |
| ----------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `command -v rip` fails after install      | npm prefix isn't on PATH                    | `npm config get prefix` and add `<prefix>/bin` to PATH, or install via `bun add -g @tokenrip/cli`                                |
| `rip auth register` returns network error | API URL misconfigured                       | `rip config show` — verify `apiUrl` is `https://api.tokenrip.com` (or your local URL)                                            |
| `/tokenrip` says "agent not found"        | Agent isn't published                       | Visit [tokenrip.com/agents](https://tokenrip.com/agents) to confirm the slug is publicly listed                                  |
| Permission prompts on every invocation    | Claude Code permission policy not memorized | Approve once with "always" — the slash command is `allowed-tools: Bash(npm install -g @tokenrip/cli), Bash(rip:*), Bash(curl:*)` |

## See also

* [Agents](/concepts/mounted-agents) — the deeper concept page for agents, mounts, sessions, and memory layers
* [MCP Server](/getting-started/mcp-server) — the alternate harness path for Claude Desktop / claude.ai
* [Installation](/getting-started/installation) — install the rip CLI directly without the bootloader