Installation
Theselltraces 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:
SELLTRACES_GITHUB to use a mirror:
arm64/x64. On Alpine/musl, use the npm
package below.
Windows (PowerShell)
Downloadsselltraces.exe into %USERPROFILE%\.selltraces\bin and adds it to
your user PATH:
$env:SELLTRACES_VERSION before piping to iex.
Run with npx
Install globally
Install from source
Requirements
The install script needs onlycurl and unzip (preinstalled on macOS and most
Linux). The npm/source paths additionally need:
- Node.js
>=22 - A SellTraces account for production uploads
- Local transcript stores from supported AI-agent tools
sqlite3on the system path for Cursor and local trace-index scanning
Local files
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 |
0600 permissions where the platform supports them.