​
Quickstart

1

Install

Downloads the prebuilt binary for your platform, installs it to ~/.selltraces/bin, and adds it to your PATH. (No package manager? See Installation for the npx/npm options.)
2

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.
3

Come back later

This scans approved sources, shows new traces and pending projects, and uploads only after explicit confirmation.
4

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:
5

Preview before uploading

Preview output includes accepted traces, skipped traces, skipped reasons, local redaction count, source breakdown, upload chunks, and preliminary value.
6

Inspect or fix local state

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:
Add one-off blocked terms without changing the saved policy:

​
Check your local state

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.