Installation

Install the Traces CLI on macOS, Linux, or via npm.

Installation methods

Homebrew (macOS / Linux)

brew install market-dot-dev/tap/traces

npm

npm i -g @traces-sh/traces

Shell script

curl -fsSL https://www.traces.com/install | bash

Optional: set up sharing from your agent after install:

traces setup
traces setup skills --agent claude-code

To remove sharing setup later:

traces remove skills
traces remove skills --global

Verify installation

traces version

Upgrading

# Via the CLI
traces upgrade

# Specific version
traces upgrade 0.5.0

# Via Homebrew
brew upgrade traces

Uninstalling

# Remove the binary
traces uninstall

# Or via Homebrew
brew uninstall traces

# Clear all local data and credentials
traces reset --all --force

System requirements

PlatformArchitectureStatus
macOSARM64 (Apple Silicon)Supported
macOSx86_64 (Intel)Supported
Linuxx86_64Supported
LinuxARM64Supported
Windowsx86_64Supported
WindowsWSLSupported via Linux binary

Troubleshooting

Run the diagnostic tool:

traces doctor

This checks your installation, authentication status, network connectivity, and agent detection. See CLI Troubleshooting for common issues.

On this page