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 | bashInstall with the share skill pre-configured:
curl -fsSL https://www.traces.com/install | bash -s -- --install-share-skillVerify 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.