Traycer Docs

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 (x64)	Download .exe	Native installer for 64-bit Windows.
Windows (via WSL)	Install via WSL	Run the Linux desktop app through WSL with WSLg.

All releases are published on GitHub.

Windows via WSL

If your Windows setup supports Linux GUI apps with WSLg, you can alternatively run the Linux desktop app through WSL. 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

Open Traycer

Launch the desktop app.

Choose a workspace folder

Pick the repository or folder Traycer should work with.

Set up a coding agent

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

Run the Quickstart

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

​Windows via WSL

​macOS via Homebrew

​CLI

​After Install

Windows via WSL

macOS via Homebrew

CLI

After Install