Commands - Paper Compute Docs

Full reference for the paper CLI.

`paper start`

Launch a supported client through the local proxy. Sets ANTHROPIC_BASE_URL for the launched process.

paper start [client]

`paper shell`

Print Paper’s shell init script for bash, zsh, or fish. The script installs a claude function that wraps invocations through paper start claude, so plain claude always routes through the proxy.

eval "$(paper shell zsh)"    # add to .zshrc
eval "$(paper shell bash)"   # add to .bashrc
paper shell fish | source    # add to config.fish

The installer offers to add this to your rc file on first install.

`paper init`

Start paperd in the background and open the local proxy.

paper init

Auto-discovers the default gateway and backend, and keeps a short-lived JWT warm so agents skip long-lived API keys.

`paper status`

Show the proxy address, auth health, current user, and org.

paper status

paperd:    running (pid 2330)
proxy:     127.0.0.1:51539
auth:      healthy (expires in 14m59s)
user:      [email protected]
org:       your-org
gateway:   default
backend:   ant-default
upstream:  https://your-org.papercompute.run/

`paper logs`

Print recent paperd logs.

paper logs
paper logs -n 500

-n / --lines sets how many recent lines to show (default 100).

`paper login`

Open a browser for WorkOS auth. Re-run to switch accounts.

paper login

`paper whoami`

Show the currently logged-in identity.

paper whoami
paper whoami --json

--json emits JSON instead of a human summary — handy for scripts.

`paper logout`

Clear daemon-owned credentials. Run paper login to sign back in.

paper logout

`paper org`

Manage organization context.

Use paper org membership add to add a teammate to the active org (requires the admin role):

paper org membership add [email protected]

When the new member runs paper login, the org is pre-selected and the CLI auto-discovers the default gateway — admins provision it during org setup on console.papercompute.com.

Use paper org select when you belong to more than one org and need to choose which gateway paper routes through:

paper org select

The new selection takes effect the next time paper starts. If it’s already running, restart it:

paper init

`paper show`

Show the active organization, or a specific org by slug.

paper show
paper show your-org

`paper tapes`

Create, inspect, and manage tapes AI gateway instances and their LLM backends.

paper tapes create
paper tapes gateway
paper tapes backend

Bootstrap interactively

Use paper tapes create when an org has no default gateway, or when you want to provision a second one:

paper tapes create

Manage gateways

Subcommand	Description
`paper tapes gateway create`	Create a new gateway
`paper tapes gateway list`	List gateways
`paper tapes gateway get`	Get gateway details
`paper tapes gateway delete`	Delete a gateway
`paper tapes gateway use`	Mark a gateway as the primary one `paperd` routes through

Manage backends

Backends are scoped to a gateway — every command takes --gateway [name].

Subcommand	Description
`paper tapes backend create`	Create a backend
`paper tapes backend list`	List backends
`paper tapes backend get`	Get backend details
`paper tapes backend delete`	Delete a backend
`paper tapes backend use`	Mark a backend (and its gateway) as primary

`paper doctor`

Check and repair the Paper installation: daemon, login, organization, and route. Prompts only where a choice is needed.

paper doctor

`paper configure`

Review and change Paper settings interactively. Runs the paper doctor checks first, then opens a settings menu.

paper configure

`paper menu`

Manage the menu-bar / system-tray app. Bare paper menu runs it in the foreground (same as paper menu run).

paper menu install
paper menu run
paper menu uninstall

paper menu install is the recommended setup — it installs a launchd agent (macOS) so the menu auto-starts on login and survives reboots. Picking Quit from the menu keeps it quit until the next login. paper menu uninstall stops the agent and removes it.

`paper version`

Print version information.

paper version

`paper uninstall`

Completely remove paperd and all local Paper state — the supervisor unit, control socket, credentials, daemon config, and logs — as if Paper was never installed.

paper uninstall

To start again, run paper init and paper login.

Configuration

org context

Which organization paper routes through. Auto-selected on paper login if you belong to one; choose with paper org select if you belong to multiple. View with paper status.

gateway context

Which tapes AI gateway paper routes inference through. Auto-discovered from the org default on paper init; manage with paper tapes gateway.

backend context

Which LLM backend the active gateway routes to. Provisioned alongside the gateway by default; manage with paper tapes backend. Stores the upstream API key and model allowlist.

ANTHROPIC_BASE_URL

Environment variable Claude Code reads to find an alternate API endpoint. paper start claude sets it automatically for the launched process. To wire it up yourself, copy the proxy address from paper status and export it:

export ANTHROPIC_BASE_URL=http://127.0.0.1:51539

The port can change when the proxy restarts, so prefer paper start claude — or add eval "$(paper shell zsh)" (or the bash/fish equivalent) to your shell rc to install a claude wrapper that always routes through the proxy.

config location

Credentials and local state live in ~/.config/paper/. Removing this directory wipes your login — running paper login again recreates it.