Installation

The selltraces binary is the normal entry point: it starts setup on a first run and resumes review for new traces on configured machines.

Install script (recommended)

Downloads the prebuilt binary for your platform into ~/.selltraces/bin and adds it to your PATH:

curl -fsSL https://selltraces.com/selltraces/install | bash

Pin a release by passing its tag, or set SELLTRACES_GITHUB to use a mirror:

curl -fsSL https://selltraces.com/selltraces/install | bash -s -- @selltraces/cli@0.1.5

The script supports macOS and Linux on arm64/x64. On Alpine/musl, use the npm package below.

Downloads selltraces.exe into %USERPROFILE%\.selltraces\bin and adds it to your user PATH:

irm https://selltraces.com/selltraces/install.ps1 | iex

Pin a release with $env:SELLTRACES_VERSION before piping to iex.

npx @selltraces/cli

npm install -g @selltraces/cli
selltraces

Other package managers:

pnpm dlx @selltraces/cli
bunx @selltraces/cli

git clone https://github.com/idanmann10/Sell-AI-Your-Traces.git
cd Sell-AI-Your-Traces
pnpm install
pnpm --filter @selltraces/cli dev

The install script needs only curl and unzip (preinstalled on macOS and most Linux). The npm/source paths additionally need:

The CLI stores private local state under ~/.selltraces:

File	Purpose
`credentials.json`	Machine token and API base after login
`config.json`	Approved sources and blocked terms
`traces.db`	Local trace index and upload ledger for accepted uploads

Local state files are written with private 0600 permissions where the platform supports them.