Quickstart
Install
curl -fsSL https://selltraces.com/install | bash
~/.selltraces/bin, and adds it to your PATH. (No package manager? See
Installation for the npx/npm options.)First run
This links your machine, discovers local sources, lets you approve what can
be inspected locally, previews the first upload, and asks before any trace
content leaves your computer. Come back later
This scans approved sources, shows new traces and pending projects, and
uploads only after explicit confirmation. Approve the browser login
The CLI prints a short verification URL, a user code, and a complete approval link. Sign in at the link and approve the code.For SSH or headless terminals, run:selltraces login --no-browser
Preview before uploading
selltraces upload --dry-run
Inspect or fix local state
selltraces status
selltraces policy
selltraces doctor
status is read-only state, policy edits sources/projects/blocked terms,
and doctor diagnoses auth, sources, and the local ledger.Common source filters
Limit a command to specific source families:
selltraces upload --dry-run --only claude,cursor,codex
selltraces upload --only codex
selltraces upload --dry-run --exclude-term "private-repo-slug"
selltraces upload --exclude-term "client-name"
Check your local state
selltraces delta
selltraces delta --json
selltraces status
selltraces status --json
delta shows cached ledger state before any scan. status shows authentication state, API base, detected source locations, saved approved sources, blocked-term count, local ledger count, pending retry-cache size, and local lifetime queued estimate.
Estimates are not earned money. Dashboard estimates and final payouts are authoritative after server-side quality, uniqueness, buyer fit, sale, and payout processing.
