Quickstart -- Treeship -- Treeship

No account, email, or API key required. Everything runs locally.

One-liner setup

curl -fsSL treeship.dev/setup | sh

This installs the CLI, initializes your ship, and instruments any detected agent frameworks (Claude Code, Cursor, Hermes, OpenClaw).

Or step by step

Install

curl -fsSL treeship.dev/install | sh

Initialize

treeship init

✓ Treeship initialized
  Ship ID:  ship_xxx
  Key ID:   key_xxx

Instrument your agents (optional)

treeship add

Auto-detects Claude Code, Cursor, Hermes, OpenClaw and configures Treeship integration.

Start a session

treeship session start --name "my first task"

Wrap commands

treeship wrap -- npm test
treeship wrap -- git commit -m "fix bug"

Every wrapped command gets a signed artifact with exit code, duration, and output digest.

Close and create your receipt

treeship session close \
  --summary "Fixed the auth bug and added a regression test"

This creates a .treeship package with a self-verifying preview.html that opens in your browser.

Verify locally

treeship package verify .treeship/sessions/ssn_*.treeship

Should show all PASS. This runs offline with zero network calls.

treeship hub attach --endpoint https://api.treeship.dev
treeship session report

Prints a permanent public URL like https://treeship.dev/receipt/ssn_xxx. No auth needed to view it.

Interactive quickstart

For a fully guided experience:

treeship quickstart

Walks through init, wrapping a command, and creating a receipt interactively.

Environment variables for richer receipts

Set these before running commands to capture model and token data:

export TREESHIP_MODEL=claude-opus-4-6
export TREESHIP_TOKENS_IN=12000
export TREESHIP_TOKENS_OUT=3000
export TREESHIP_PROVIDER=anthropic  # optional

Cost is not captured in receipts. Pricing depends on provider, tier, and timing. Receipts store verifiable usage (model + tokens). Cost is calculated by consumer tools (Witness dashboards, billing) from their pricing config.

Live monitoring

While your agent works, watch the session in real time:

treeship session status --watch

What's next

Session Receipts -- understand the receipt format
Claude Code integration -- setup for Claude Code
CLI reference -- all commands

Quickstart

On this page