Installation
Install the Traces CLI on macOS, Linux, or via npm.
Installation methods
Homebrew (macOS / Linux)
brew install market-dot-dev/tap/tracesnpm
npm i -g @traces-sh/tracesShell script
curl -fsSL https://www.traces.com/install | bashOptional: set up sharing from your agent after install:
traces setup
traces setup skills --agent claude-codeTo remove sharing setup later:
traces remove skills
traces remove skills --globalVerify installation
traces versionUpgrading
# Via the CLI
traces upgrade
# Specific version
traces upgrade 0.5.0
# Via Homebrew
brew upgrade tracesUninstalling
# Remove the binary
traces uninstall
# Or via Homebrew
brew uninstall traces
# Clear all local data and credentials
traces reset --all --forceSystem requirements
| Platform | Architecture | Status |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | Supported |
| macOS | x86_64 (Intel) | Supported |
| Linux | x86_64 | Supported |
| Linux | ARM64 | Supported |
| Windows | x86_64 | Supported |
| Windows | WSL | Supported via Linux binary |
Troubleshooting
Run the diagnostic tool:
traces doctorThis checks your installation, authentication status, network connectivity, and agent detection. See CLI Troubleshooting for common issues.