Skip to main content
​
More detail when diagnosing a Host crash.
  • Crash diagnostics — Host crash reports now include a breakdown of memory use to help identify what grew before the crash.
  • Previous exit — the CLI records whether the Host ran out of memory, crashed, stopped, or exited cleanly, so a compatible Host can report how its predecessor ended.
See the GitHub release.
​
Move your Windows data folder, start Tasks from the terminal, and recover more easily from setup and update problems.
  • Windows data folder - choose a folder for a new installation or move existing data to another fixed local NTFS drive. Preview the move, review its effect on sessions, and recover an interrupted move with data folder commands.
  • Tasks and agents - start a Task with its first message using traycer task create, including an idempotency key for scheduled runs. Rename an agent with traycer agent rename.
  • Host authorization - traycer login also authorizes a Host already running on this machine, so CLI-only installations can recover cross-machine messaging without Desktop.
  • Updates and diagnosis - host status shows the last update result and any current update-lock holder. host doctor reports the running Host’s checks and warns when a different CLI version comes first on PATH. A normal CLI upgrade never installs an older version.
  • Setup and shutdown - Windows service checks work on non-English systems, and denied launcher writes explain what to allow. Linux service commands explain when a systemd user session is missing; macOS stops give the Host time to finish saving.
See the GitHub release.
​
Starting the Host recovers from an abandoned update download or preparation attempt once it is stale and no updater holds it. An update still being applied remains protected.See the GitHub release.
​
Manage provider profiles from the terminal, with clearer protection when rolling back the Host.
  • Provider profiles — traycer profile lists, adds, signs in, renames, enables, disables, and removes profiles for Claude Code, Codex, Grok, and Antigravity. See profile commands.
  • Host rollback — before installing an older Host, the CLI also checks whether it can read the local task store. --accept-store-format-loss explicitly accepts that local tasks may be unavailable until a compatible Host is installed again; nothing in the task store is deleted.
See the GitHub release.
​
Quieter crash reporting and fixes for sign-in cancellation and shell notifications.
  • Crash reports — repeated failures of the same kind on one machine are grouped over an hour instead of sending a report for every command. Request-ended errors keep their cause so they can be distinguished from rejected credentials.
  • Provider sign-in — cancellation is scoped to the sign-in attempt that owns the login.
  • Notifications — a shell-output notification waiting for delivery now links to its chat.
See the GitHub release.
​
More reliable provider sign-in and Host restarts on macOS.
  • Provider sign-in — sign-in continues while the Host prepares the provider CLI, and refusals and account-verification requests are surfaced.
  • Models — model names still match when a provider drops a tier marker from its model slug.
  • macOS Host service — if neither the Desktop-managed nor CLI-managed service is loaded, start and restart commands explain how to recover: quit and reopen Traycer Desktop, or run traycer host service install to register the CLI-managed service.
See the GitHub release.
​
Restarts and updates that recover cleanly, a cooperative stop on Windows, and a lighter Host on macOS.
  • Host restart — on macOS and Linux, a restart that takes longer than expected is no longer reported as failed. If the service manager doesn’t answer in time, the CLI says the restart is unconfirmed. A restart while an installed update is waiting for a busy Host now starts the Host on that update instead of leaving it stopped.
  • Clearer recovery — when an update is waiting and the Host isn’t running, host status points to traycer host update. Commands refused because of a pending update name it and say how to recover.
  • Updates — a downgrade you confirmed with --accept-store-format-loss still applies when the update has to wait for a busy Host.
  • Windows — host stop and host restart ask the Host to shut down cleanly first. While the Host has work in progress, both are refused rather than cutting that work off. --force still stops it.
  • macOS memory — the Host starts with the system allocator’s large-block cache turned off, so freed large blocks are given back instead of held.
  • Agent list — when the Host can tell, traycer agent list shows whether an agent’s session is running, sleeping, or stopped, so a sleeping agent isn’t mistaken for a stopped one.
  • Host logs — rotating host.log at start now shifts older logs down instead of overwriting the one the Host just rotated out.
  • Crash reports — expected outcomes, such as an expired sign-in, are no longer sent as crash reports.
  • Fixes — a Host request containing a Unicode line separator is no longer broken apart; the notice for an agent stopped before replying no longer claims the user stopped it; and monitor hints tell agents to follow up with --expect-reply.
​
Reliable Host updates, a way to sign in the mobile app, and clearer commands.
  • Breaking: Node.js 22.13 for npm installs — the npm package now needs Node.js 22.13 or later; it needed 20.18 before. Update Node.js before you upgrade through npm. Homebrew and Traycer Desktop install a standalone binary that does not need Node.js.
  • Host updates — traycer host update shows progress, waits instead of interrupting busy work, and can move to an older release with --release and --allow-downgrade. A Host you deliberately downgraded is no longer upgraded again behind your back.
  • Mobile app — traycer link-phone signs the Traycer mobile app in by scanning a code, and shows a match code to compare on both sides.
  • Self-upgrade — upgrading the CLI installs exactly the version it reports.
  • Clearer commands — host lifecycle and sign-in commands say what they actually do, host status and doctor only observe unless asked to repair, and help and human-readable output are cleaned up.
  • npm and nvm installs — the Host finds a CLI installed through npm or nvm.
  • Crash reports — Host crashes are reported from the supervisor so they can be diagnosed.
  • Fixes — commands that stop the Host survive the stop on Linux and Windows, Windows Host processes are stopped by identity rather than by process id, and read-only agents are held to the read-only command set.
​
Remote hosts, new agent commands, and a Host that recovers on its own.
  • Remote hosts — install and sign in a Host on another machine, and connect to it from the app.
  • Agent commands — traycer agent fork, traycer agent stop, and traycer agent archive. traycer agent list shows the settings each agent actually runs with.
  • Host lifecycle — host install signs in the Host it starts, keeps your provider CLIs across updates, and accepts --force. host stop and host restart take --force for stuck work.
  • Crash recovery — a crashed Host is relaunched instead of leaving the machine without one, and the Host keeps running when a child process runs out of memory.
  • Linux and Windows — the Host service is more reliable on Linux, with new doctor checks, and cleaner to install and remove on Windows.
  • macOS — the Host appears in Login Items as Traycer rather than sh.
  • Fixes — large command output is no longer cut off, and doctor reports when the Host needs you to sign in again.
​
Proxy support and easier-to-diagnose Host crashes.
  • Breaking: --epic-id and --sender-agent-id removed — agent, workspace, and monitor commands no longer take these flags. They read the Task from TRAYCER_EPIC_ID and the calling agent from TRAYCER_AGENT_ID, which Traycer sets for the agents it launches. Scripts that pass either flag now fail with an unknown-option error.
  • Proxies — the CLI honours HTTP_PROXY, HTTPS_PROXY, and NO_PROXY.
  • Epic Mode removed — traycer agent create no longer offers Epic Mode.
  • Agent-to-agent — agents created by other agents run with full access.
  • Crash diagnosis — the supervisor records why the Host crashed.
  • Fixes — installing the Host on Windows survives a locked file, and connections recover after a Host timeout.
​
Agent roles, the Oh My Pi coding agent, and Host installs that recover instead of leaving you stuck.
  • Agent roles — agents claim, list, and give up named roles in a Task with traycer agent role claim, list, and relinquish, when agent roles are turned on in Settings.
  • Oh My Pi — create agents with --harness omp.
  • Command help — command descriptions now spell out what each command actually does.
  • Installing the Host — a failed install or update offers a way forward instead of leaving you stuck. On macOS, the Host no longer runs slowed down in the background, and appears in Login Items as Traycer rather than sh.
  • Fixes — browser sign-in completes as soon as you approve it, rather than waiting out a longer polling delay, and environment variable overrides on Windows keep their original capitalization.
​
One sign-in shared with the desktop app, and downloads that resume.
  • Shared sign-in — the CLI and Traycer Desktop use the same credentials, so signing in once really does cover both.
  • Agent permissions — set what an agent is allowed to do when creating or reconfiguring it.
  • Installing the Host — large downloads resume where they left off.
  • Fixes — the CLI now recognizes when the desktop app already manages the Host service, and replaces a competing registration rather than just refusing it.
​
Account-aware agent commands, Devin and Pi, and steadier Host service registration.
  • Choose an account per agent — list the accounts available for a provider and their usage, pick one when creating an agent, and switch the account an existing agent uses.
  • Devin and Pi — both coding agents are now available.
  • Shell configuration — add or remove custom shells, and restore a shell’s default arguments.
  • Worktrees — listings fetch current status every time you run them.
  • Service registration — the Host service stays correctly registered across installs and updates.
  • Open source — Traycer’s public repository is now MIT-licensed.
​
  • Compatibility — a newer CLI keeps working with an older Host; anything unavailable asks you to update rather than breaking the connection.
  • Reliability — requests finish before their connection closes.
​
Windows binaries, the Amp coding agent, and new worktree commands.
  • Windows — prebuilt Windows binaries alongside macOS and Linux.
  • Amp — the Amp coding agent from Sourcegraph is now available.
  • Worktree commands — traycer worktree list and traycer worktree delete, showing which worktrees are stale and paging as the list grows.
  • Terminal agents — Claude and OpenCode keep the correct session when it changes.
​
  • Git diffs — change data can include edits made inside Git submodules.
  • Scheduled wake-ups — remain compatible with earlier 1.1 releases.
  • Terminal agents no longer die quietly when the connection drops.
​
  • Named agents — give an agent a name when you create it.
  • Provider lists load correctly when the CLI and Host are on different versions.
​
  • Homebrew — install a specific CLI version.
  • Sign-in — a stalled sign-in now times out instead of hanging indefinitely.
​
  • Host updates recover instead of staying blocked, and refuse to restart while work is still running.
​
Install from npm or Homebrew, sign in from any device, and eight new coding agents.
  • Install from npm or Homebrew — published to both.
  • Device sign-in — sign in by approving Traycer on a web page, shared with Traycer Desktop.
  • Eight new coding agents — Grok (xAI), Qwen, Kiro, Kilo Code, Copilot, Kimi, Droid, and OpenRouter.
  • Windows Hosts — support for bundled Windows Host archives.
  • Diagnostics — choose how much the CLI logs.
  • Sign-in — long-running traycer monitor sessions refresh credentials ahead of expiry and update open Host connections without reconnecting.
  • Removing the Host — traycer host uninstall --all removes the Host for good, instead of leaving it to restart itself part-way through.
​
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. It ships inside Traycer Desktop, so most users do not install it separately.
  • Single binary — a self-contained executable with no external runtime dependency.
  • Host lifecycle — download, verify, install, start, update, and supervise the Host as an OS-managed service. Binaries are verified by SHA-256 checksum and minisign signature before installation.
  • Authentication — browser-based PKCE sign-in (traycer login / whoami / logout), 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.
  • Scripting — --json emits a structured NDJSON stream of progress and result events; honors CI and TRAYCER_NONINTERACTIVE, plus --quiet / --no-progress.
  • Platforms — prebuilt binaries for macOS (Apple Silicon and Intel) and Linux (x64).