host manifest

Rolling host registry manifest (versions.json). Do not delete.

Traycer Host 1.0.0

The first public release of the Traycer Host, the local runtime that powers Traycer. The Host runs the coding agents, terminals, and Tasks behind Traycer Desktop, entirely on your machine.

You do not install the Host directly. The Traycer CLI, bundled with Traycer Desktop, downloads the correct build for your platform, verifies its signature, installs it as a managed background service, and keeps it running and up to date.

What it does

• Runs your chosen AI coding agents directly on the repositories you are working in.
• Stores Tasks, conversations, plans, and history in a local SQLite database.
• Manages terminals, files, and git worktrees.
• Exposes a versioned protocol that Traycer Desktop connects to.

It registers with your operating system's service manager (launchd on macOS, systemd user on Linux), so it starts with your session and is supervised automatically.

Agents and models

The Host runs several coding-agent backends behind one surface, selectable per Task:

• Claude (Claude Code), via the Anthropic Claude Agent SDK.
• OpenAI Codex, with selectable reasoning depth and an optional Fast service tier.
• Cursor, via the Cursor SDK, configured with a Cursor API key.
• OpenCode, via the OpenCode SDK.
• Traycer Inference, Traycer's hosted inference service.

Provider credentials and API keys come from your provider settings. The Host does not log secrets or source code.

Skills

The Host ships Traycer's structured skills: the workflows for drafting a Task brief, producing a technical plan, breaking work down, executing step by step, and reviewing changes. Skills are versioned and integrity-checked.

Platforms

The Host is delivered as a signed, single-file runtime per platform, with no separate Node or Bun installation required:

• macOS (Apple Silicon and Intel)
• Linux (x64)

The CLI resolves versions from a rolling registry manifest published alongside these releases. For each platform the manifest carries a download URL, a SHA-256 checksum, and a minisign signature, and the CLI verifies both the checksum and the signature before installing.

Notes

The companion host manifest release holds the registry (versions.json) the CLI reads to discover and verify host versions; it is infrastructure, not a download. The Host is provisioned and supervised by the Traycer CLI, so no manual install is needed. Documentation is at docs.traycer.ai. Traycer is open source under the Apache-2.0 license at github.com/traycerai/traycer.

Traycer Desktop 1.0.0

The first public release of Traycer Desktop, the native application that brings Traycer's AI pair-programming workflow to your machine. Sign in, point it at a repository, and delegate engineering work to coding agents in a local-first workspace.

Traycer Desktop bundles the Traycer CLI and provisions the local Traycer Host automatically, so there is nothing else to install or configure.

Overview

Traycer organizes work into Tasks. A Task is a long-lived workspace bound to a repository where you plan, chat with agents, run terminal agents, review diffs, and keep the full history of a piece of work in one place. Everything is stored locally on your machine.

Features

Coding agents, your choice. Connect Claude (Claude Code), OpenAI Codex, Cursor, OpenCode, or Traycer Inference, and switch per conversation without restarting. Configure providers and credentials in Settings > Providers. On supported models you can set reasoning effort and an optional Fast service tier.

Chats. Hold persistent conversations with an agent, run several in parallel, and track accumulated changes per conversation. Drafts save automatically and can be promoted into a Task.

Terminal agents. Launch terminal-based agents inside a Task on a full xterm terminal with color, scrollback, and theming. Sessions persist across host restarts.

Plan and review. Review proposed changes as side-by-side git diffs, open project files, and leave comment threads on specific lines.

Worktrees. Traycer creates isolated git worktrees for agent work so your main checkout stays clean. Manage them in Settings > Worktrees.

Multiple machines. Choose the machine a chat or terminal runs on. Each tab stays bound to its host for its lifetime.

Native desktop. System tray with recent Tasks, native notifications, a command palette (Cmd/Ctrl+K), customizable keybindings, multiple windows, the traycer:// deep-link scheme, and light, dark, and system themes.

Sign in once. Secure browser-based (PKCE) sign-in, shared automatically with the bundled CLI. Sessions persist across restarts and refresh automatically.

Background updates. Traycer checks for updates, downloads them in the background, and installs them on quit, using signed release artifacts.

Download

Download the build for your platform from the Assets below.

Platform	File
macOS (Apple Silicon)	traycer-desktop-macos-arm64.dmg
macOS (Intel)	traycer-desktop-macos-x64.dmg
Linux (AppImage, portable)	traycer-desktop-linux-x86_64.AppImage
Linux (Debian / Ubuntu)	traycer-desktop-linux-amd64.deb
Linux (Fedora / RHEL)	traycer-desktop-linux-x86_64.rpm

Requirements: macOS 12.0 or later (Apple Silicon or Intel), or a 64-bit Linux desktop. macOS builds are signed and notarized.

Getting started

1. Install and open Traycer Desktop.
2. Sign in with your Traycer account.
3. Choose a workspace folder.
4. Set up a coding agent in Settings > Providers.
5. Create your first Task and start a chat.

Notes

Traycer Desktop bundles the Traycer CLI and provisions the Traycer Host automatically; neither needs separate installation. Documentation is at docs.traycer.ai. Traycer is open source under the Apache-2.0 license at github.com/traycerai/traycer.

Traycer CLI 1.0.0

The first public release of the Traycer CLI, the traycer command that provisions and supervises the Traycer Host, handles authentication, manages configuration, and exposes Traycer's workspace and agent automation.

The CLI ships inside Traycer Desktop and runs behind the scenes, so most users do not install it directly. This release is for managing the host runtime, scripting Traycer, or driving agent workflows from the terminal.

What it does

A single self-contained binary with no external runtime dependency:

• Host lifecycle: download, verify, install, start, update, and supervise the Traycer Host as an OS-managed service.
• Authentication: browser-based sign-in, shared with Traycer Desktop.
• Configuration: shell selection and environment overrides for agent sessions.
• Workspaces and worktrees: list workspaces and create isolated git worktrees.
• Agent automation: list, create, and message agents, read transcripts, and stream inboxes.

Host management

traycer host status     # is the host running, and where
traycer host doctor     # diagnose setup problems with suggested fixes
traycer host install    # install from the signed registry
traycer host update     # move to the latest released host
traycer host logs -f    # follow host logs live

Host binaries are verified by SHA-256 checksum and minisign signature before installation. The CLI registers the host with your OS service manager (launchd on macOS, systemd user on Linux). traycer host doctor reports actionable diagnostics for common issues such as port conflicts or a missing service registration.

Authentication

traycer login     # browser-based PKCE sign-in
traycer whoami    # show the authenticated user
traycer logout    # clear stored credentials

Sign-in uses OAuth with PKCE on a local loopback callback. Credentials are stored under ~/.traycer/cli/ and are shared with Traycer Desktop, so signing in once covers both.

Scripting

Add --json to emit a structured NDJSON stream of progress and result events with explicit error codes, suitable for piping into other tools. The CLI honors CI and TRAYCER_NONINTERACTIVE to skip prompts and browser launches, and --quiet / --no-progress to reduce output in logs.

Install

The CLI is bundled with Traycer Desktop, so most users do not install it separately. Prebuilt binaries for macOS (Apple Silicon and Intel) and Linux (x64) are attached to this release under Assets.

Notes

Provider API keys are not CLI configuration; set them in Settings > Providers in Traycer Desktop. The full command reference is at docs.traycer.ai. Traycer is open source under the Apache-2.0 license at github.com/traycerai/traycer.

CLI manifest (rolling)

Rolling pointer to the latest CLI release. Holds versions.json consumed by the CLI self-update probe and package-manager checkers. Managed by update-cli-package-managers.yml.

Traycer Host 1.0.0-rc.1

Traycer Host 1.0.0-rc.1.

Traycer Desktop 1.0.0-rc.1

Traycer Desktop 1.0.0-rc.1.

Traycer CLI 1.0.0-rc.1

Traycer CLI 1.0.0-rc.1.