Install

Get Traycer Desktop running on your machine.

Download the Traycer Desktop app for your operating system. Links always point to the latest release.

Platform	Download	Notes
macOS (Apple Silicon)	Download .dmg	For M-series Macs (M1/M2/M3/M4).
macOS (Intel)	Download .dmg	For Intel-based Macs.
Linux (AppImage)	Download .AppImage	Portable; chmod +x then run.
Linux (Debian/Ubuntu)	Download .deb	sudo dpkg -i the package.
Linux (Fedora/RHEL)	Download .rpm	sudo rpm -i the package.
Windows (via WSL)	Install via WSL	Run the Linux desktop app through WSL with WSLg.
Windows (native)	Coming soon	Native installer will be listed here.

All releases are published on GitHub.

Windows via WSL

The native Windows installer is coming soon. Until then, you can run the Linux desktop app through WSL if your Windows setup supports Linux GUI apps with WSLg.

Before installing Traycer in WSL:

• Update WSL with wsl --update, then restart your Ubuntu distribution.
• Use WSL 2 on a recent Windows build with WSLg enabled.
• Set a non-Snap browser as the default browser inside WSL. Snap-installed browsers can block the sign-in redirect back to Traycer. Google Chrome installed from a .deb package works.

Then install the package that matches your WSL distribution:

Debian / Ubuntu (.deb)

wget https://github.com/traycerai/traycer/releases/latest/download/traycer-desktop-linux-amd64.deb
sudo apt install ./traycer-desktop-linux-amd64.deb

Fedora / RHEL (.rpm)

wget https://github.com/traycerai/traycer/releases/latest/download/traycer-desktop-linux-x86_64.rpm
sudo dnf install ./traycer-desktop-linux-x86_64.rpm

Other distros (portable .AppImage)

wget https://github.com/traycerai/traycer/releases/latest/download/traycer-desktop-linux-x86_64.AppImage
chmod +x traycer-desktop-linux-x86_64.AppImage
./traycer-desktop-linux-x86_64.AppImage

Launch Traycer from WSL (.deb / .rpm installs):

/opt/Traycer/traycer-desktop

You may also see Traycer in the Windows Start menu if WSLg has registered the desktop app.

macOS via Homebrew

On macOS you can also install the desktop app with Homebrew:

brew install --cask traycerai/traycer/traycer-desktop

After installing the desktop app, open Traycer and choose the workspace folder you want to work in.

CLI

The desktop app bundles the command-line pieces it needs, so most users do not have to install the CLI separately.

To use the CLI on its own — for host control, automation, or CI — install it with npm (requires Node.js 20.18+):

npm install -g @traycerai/cli

Or with Homebrew on macOS and Linux:

brew install traycerai/traycer/traycer

Both install the traycer command. Verify with traycer --version. See the full command reference.

After Install

1. Open Traycer

   Launch the desktop app.

2. Choose a workspace folder

   Pick the repository or folder Traycer should work with.

3. Set up a coding agent

   Configure Codex, Claude Code, OpenCode, Cursor, or Traycer in Agents & Models.

4. Run the Quickstart

   Continue with the Quickstart to create your first Task and start a chat.