Skip to content

Traycer CLI 1.0.0

Choose a tag to compare

View all tags
@hdkshingala hdkshingala released this 23 Jun 20:21
· 15 commits to main since this release
cli-v1.0.0
096c25e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.

Assets 19
Loading