CLI setup

The paper CLI runs locally and captures supported agent sessions to paper console.

This page covers the pieces of the paper CLI itself — how to install and update it, how to authenticate, how the local daemon works, which clients are supported, and the commands you’ll reach for day to day. For an end-to-end walkthrough, see the Quickstart.

Install

curl -fsSL https://download.papercompute.com/install | sh

That puts paper on your PATH. To update, re-run the install command. Check the installed version with:

paper --version

Authenticate

paper login

Opens a browser for WorkOS auth. Sign in with your work email so the paper CLI can route captured sessions to the correct paper console account.

Run paper login again to switch accounts.

Organizations

If you belong to multiple organizations, choose which one the paper CLI routes through:

paper org select

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

Invite a teammate:

paper org invite [email protected]

Need to create an organization?Optional

If you’re the first person on your team, head to console.papercompute.com to name your org. The console provisions a default gateway and Anthropic backend so the paper CLI has something to route through.

Invited by someone? Skip this — your org is already set up.

The local daemon (paperd)

After authentication, the paper CLI runs a local daemon called paperd that routes supported agent sessions to paper console.

Check it from the CLI:

paper status

paper status prints the proxy address, auth health, current user, and org. On macOS, the paper menu bar item also shows daemon status and shortcuts for logs and re-authentication.

If paperd isn’t running, start it with:

paper init

Stream logs with paper logs --follow.

Supported clients

Claude Code is the first supported client. More clients and providers are coming later.

Run Claude Code through the paper CLI:

paper start claude

This launches Claude Code with the proxy already wired up so the session is captured to paper console.

Common commands

Task	Command
Start Claude Code through the paper CLI	paper start claude
Check proxy status	paper status
View logs	paper logs --follow
Switch orgs	paper org select
Invite a teammate	paper org invite [email protected]

For the full command reference and configuration, see Commands. For setup issues, see Troubleshooting.