# Traycer AI

- [What is Traycer?](https://docs.traycer.ai/index.md): Traycer is an open-source desktop app for running Claude Code, Codex, Cursor and other AI coding agents in parallel, with shared plans and code review.
- [Install](https://docs.traycer.ai/install.md): Get Traycer Desktop running on your machine, keep it updated, and remove it.
- [First run and importing](https://docs.traycer.ai/first-run.md): What happens the first time you open Traycer Desktop: signing in, host setup, the introduction, importing your Claude Code, Codex and OpenCode sessions, and the setup guides.
- [Quickstart](https://docs.traycer.ai/quickstart.md): Sign in, send your first prompt to start a Task and its first agent, and review the result.
- [Plan a feature with artifacts](https://docs.traycer.ai/guides/plan-a-feature.md): Have agents frame, plan, and break down a feature as artifacts, review the plan with comments, then build from the tickets.
- [Run agents in parallel on worktrees](https://docs.traycer.ai/guides/parallel-agents-on-worktrees.md): Give each agent its own worktree and branch so several can change the same repository at once, then review the branches and clean up.
- [Review agent changes](https://docs.traycer.ai/guides/review-agent-changes.md): Check what an agent changed, get a written review, send fixes back, and roll back what you don't want.
- [Work across two machines](https://docs.traycer.ai/guides/work-across-machines.md): Add another machine as a host, run agents there from this window, open its dev servers here, and keep going when one machine is offline.
- [Tasks and Workspace Folders](https://docs.traycer.ai/concepts/tasks-and-workspace-folders.md): Understand Tasks, Task tabs, and workspace folders in Traycer Desktop.
- [Artifact workflow](https://docs.traycer.ai/concepts/artifact-workflow.md): How agents use Traycer's built-in skills to plan, build, and review work through artifacts.
- [Agent-to-Agent](https://docs.traycer.ai/concepts/agent-to-agent.md): How Traycer agents create child agents, message each other across Tasks and hosts, read each other's transcripts, and show up in the Agent office.
- [Terminal Agents VS Terminals](https://docs.traycer.ai/concepts/terminal-agents-vs-terminals.md): Understand the difference between an agent on the Terminal interface and a plain shell terminal.
- [Worktrees](https://docs.traycer.ai/concepts/worktrees.md): Understand how Traycer uses workspace folders and git worktrees for agents and diffs.
- [Setup and teardown scripts](https://docs.traycer.ai/concepts/worktrees/scripts.md): Run commands when Traycer creates or removes a worktree, and choose how new worktree branches are named.
- [Sweep](https://docs.traycer.ai/concepts/sweep.md): Clean up Task worktrees, understand what gets deleted, and review work that may still be needed.
- [Hosts](https://docs.traycer.ai/concepts/hosts.md): Understand the Traycer process that runs agents, terminals and file access on each of your machines.
- [Remote hosts](https://docs.traycer.ai/concepts/hosts/remote-hosts.md): Add a host on another machine and make it your active host.
- [Port forwarding](https://docs.traycer.ai/concepts/hosts/port-forwarding.md): Reach a dev server on one of your machines from another, through a port an agent forwards.
- [Resource monitor](https://docs.traycer.ai/concepts/hosts/resource-monitor.md): See CPU and memory for your agents, shells and processes, and stop or kill selected work.
- [History](https://docs.traycer.ai/concepts/history.md): Find, search, filter, organize, open, and clean up previous Tasks.
- [Sync and offline](https://docs.traycer.ai/concepts/sync-and-offline.md): What the sync indicator in a Task means, what happens to your changes when you go offline, and how agents on offline machines appear.
- [Notifications](https://docs.traycer.ai/concepts/notifications.md): How Traycer tells you an agent needs you, failed, or finished: the notification center, tab indicators, OS and phone notifications, sounds, and hooks.
- [Search and navigation](https://docs.traycer.ai/concepts/search-and-navigation.md): Find commands, Tasks and chat messages, go back and forward, reopen closed tabs, work across windows, and use the Home tab.
- [Panels](https://docs.traycer.ai/panels/index.md): Understand the sidebar panels inside a Task, the rail, canvas tabs, split views, and the start page panel.
- [Agents](https://docs.traycer.ai/panels/agents.md): Create, organize, and work with agents in a Task using the Chat or Terminal interface. Formerly the Chats panel.
- [Composer](https://docs.traycer.ai/panels/agents/composer.md): Mention context, run slash commands, keep drafts, quote replies, and manage the context window.
- [Message queue](https://docs.traycer.ai/panels/agents/message-queue.md): Queue, reorder, edit, and steer follow-up messages while an agent runs.
- [Agent questions](https://docs.traycer.ai/panels/agents/agent-questions.md): Answer structured questions and compare alternative answers in a fork.
- [Undo a turn](https://docs.traycer.ai/panels/agents/undo-a-turn.md): Restore the files and artifacts an assistant turn changed, or undo everything an agent changed.
- [Terminals](https://docs.traycer.ai/panels/terminals.md): Use Terminals for plain shell sessions.
- [Browsers](https://docs.traycer.ai/panels/browsers.md): Open web pages inside Traycer, watch and guide agents that use the in-app browser, and view browser tabs that run on other machines.
- [Artifacts](https://docs.traycer.ai/panels/artifacts.md): Browse, organize, and track the specs, tickets, stories, and reviews in a Task.
- [Editing artifacts](https://docs.traycer.ai/panels/artifacts/editing.md): Write and format artifacts, link and embed content, and send passages to a chat.
- [Diagrams](https://docs.traycer.ai/panels/artifacts/diagrams.md): Add, edit, and export Mermaid diagrams in artifacts.
- [Wireframes](https://docs.traycer.ai/panels/artifacts/wireframes.md): Add live HTML previews of proposed screens to artifacts, and copy their source.
- [Version history and recovery](https://docs.traycer.ai/panels/artifacts/version-history.md): See how an artifact changed, restore an earlier version, and bring back deleted artifacts.
- [Export](https://docs.traycer.ai/panels/artifacts/export.md): Save artifacts as Markdown or PDF files, one at a time or several in a ZIP.
- [Git Diff](https://docs.traycer.ai/panels/git-diff.md): Use Git Diff to inspect and edit changed files in a workspace or worktree.
- [Pull Requests](https://docs.traycer.ai/panels/pull-requests.md): See the pull requests your Task's agents opened, check their CI and reviews, and send review feedback back to an agent.
- [File Tree](https://docs.traycer.ai/panels/file-tree.md): Use File Tree to browse workspace files.
- [Sharing](https://docs.traycer.ai/panels/sharing.md): Invite people to a Task, manage their roles, share with a team, and choose which of your agents collaborators see.
- [Comments](https://docs.traycer.ai/panels/comments.md): Discuss artifact text in anchored comment threads, and have agents address them.
- [Agents & Models](https://docs.traycer.ai/agents-and-models/coding-agents.md): Compare Traycer's coding agents: interfaces, fast mode, profiles, steering, permission modes, and how each one connects.
- [Usage limits and model routing](https://docs.traycer.ai/agents-and-models/usage-limits-and-routing.md): See how much of each provider's usage limit is left, switch accounts when one runs low, check what your agents cost, and let Traycer route a blocked chat to another account or model.
- [Sign In](https://docs.traycer.ai/account/sign-in.md): Sign in to Traycer Desktop, approve the sign-in in your browser, and sign out or switch accounts.
- [Pricing](https://docs.traycer.ai/account/pricing.md): Understand Traycer plans: Free for individuals, Sync for teams, and pay-as-you-go inference credits.
- [Teams](https://docs.traycer.ai/account/teams.md): Create a team, invite members, manage seats and credits, and share Tasks with your team.
- [Mobile App](https://docs.traycer.ai/account/mobile-app.md): Follow and steer your Tasks from your phone with the Traycer mobile app.
- [CLI](https://docs.traycer.ai/cli/commands.md): Reference for the traycer command: sign-in, running and updating the host, configuration, worktrees, and agent automation.
- [Settings overview](https://docs.traycer.ai/settings/index.md): Open Settings as a dialog or a tab, search it, and find every section in the Guide, Application, Account and Host groups, including how the host picker scopes the Host group.
- [Getting started](https://docs.traycer.ai/settings/getting-started.md): Replay the initial tour and run the setup guides for agent selection, appearance and layout, and browser sign-ins.
- [General](https://docs.traycer.ai/settings/general.md): Composer behavior, keeping the computer awake while agents run, the worktree branch prefix, experimental features, and resetting this device's app state.
- [Appearance](https://docs.traycer.ai/settings/appearance.md): Pick light and dark themes, create and import themes, and set the start page, zoom, fonts, motion, terminal, Agent office and icon colors.
- [Browser](https://docs.traycer.ai/settings/browser.md): Set the in-app browser's search engine, whether agents use it, saved website sessions and importing sign-ins, and where browser tabs open.
- [Opening behavior](https://docs.traycer.ai/settings/opening-behavior.md): Choose whether links open in Traycer or your default browser, and whether new tiles open in the current pane or a new split.
- [Sounds](https://docs.traycer.ai/settings/sounds.md): Pick the chime for each kind of notification, open your OS notification settings, and turn on push notifications in the mobile app.
- [Keybindings](https://docs.traycer.ai/settings/keybindings.md): Default Traycer Desktop keyboard shortcuts, which ones you can rebind, and how to change them.
- [Diagnostics (Application)](https://docs.traycer.ai/settings/diagnostics.md): Set the desktop app's log level, capture memory diagnostics for a report, and read the app's recent logs.
- [Layout](https://docs.traycer.ai/settings/layout.md): Apply a Default, Compact or Detailed preset, and set up the status bar, tabs, composer, chat and sidebar.
- [Account](https://docs.traycer.ai/settings/account.md): Review and sign out signed-in sessions, link the mobile app, see your account's usage, and find where each account setting lives.
- [Overview](https://docs.traycer.ai/settings/host.md): Check a host's health, update it, manage the data and ports it holds, and see how it is installed.
- [Providers](https://docs.traycer.ai/settings/providers.md): Turn coding agents on and off, and configure their credentials, profiles, CLI binaries, environment variables, MCP servers, plugins, and skills.
- [MCP servers](https://docs.traycer.ai/settings/providers/mcp-servers.md): Add, sign in to, and manage MCP servers and their tools for a coding-agent provider.
- [Skills](https://docs.traycer.ai/settings/providers/skills.md): Import or write skills, choose which providers can use them, and invoke them from chat.
- [Worktrees](https://docs.traycer.ai/settings/worktrees.md): Manage Traycer worktrees, choose whether agents may create them, configure automatic cleanup, and inspect cleanup history for each host.
- [Notifications (Host)](https://docs.traycer.ai/settings/notifications.md): Choose which notifications a host creates, and run a script or call a URL when they happen.
- [Permissions](https://docs.traycer.ai/settings/permissions.md): Choose the default permission mode, pick the judge that reviews commands in Auto mode, write Auto mode rules, and review recent decisions.
- [Agent selection](https://docs.traycer.ai/settings/agents.md): Edit the instructions Traycer agents follow when they pick a coding agent, model, and reasoning effort for a child agent.
- [Model routing](https://docs.traycer.ai/settings/model-routing.md): Choose what Traycer tries when a rate limit or another provider problem blocks a chat: another account, an equivalent model, waiting for the limit to reset, or notifying you.
- [Shell](https://docs.traycer.ai/settings/shell.md): Choose the shell a host uses for terminals and for finding your tools, set its startup flags, and set the host's own environment variables.
- [Diagnostics (Host)](https://docs.traycer.ai/settings/host-diagnostics.md): Set how much the Traycer CLI and host log, and read a host's recent log output.
- [Troubleshooting](https://docs.traycer.ai/reference/troubleshooting.md): What Traycer's status words, startup screens and messages mean, how to collect logs, and how to report an issue.
- [Changelog](https://docs.traycer.ai/changelog.md): Track the latest updates and improvements to Traycer Desktop.
- [Host Changelog](https://docs.traycer.ai/host/changelog.md): Track the latest updates and improvements to the Traycer Host.
- [CLI Changelog](https://docs.traycer.ai/cli/changelog.md): Track the latest updates and improvements to the Traycer CLI.
- [We're Retiring the IDE Extension](https://docs.traycer.ai/extension/index.md): Traycer is retiring the IDE extension on October 31, 2026, and focusing fully on Traycer Desktop. Your existing work and paid plan continue on Desktop.
- [Overview](https://docs.traycer.ai/extension/tasks/index.md): Transform complex requirements into actionable, AI‑executable plans. Traycer Tasks turn ideas into precise, step‑by‑step implementation plans that AI coding tools can follow with zero guesswork.
- [Phases Mode](https://docs.traycer.ai/extension/tasks/phases.md): Structured, multi-phase development for complex projects. Break goals into iterative phases with validation between steps.
- [Plan Mode](https://docs.traycer.ai/extension/tasks/plan.md): Direct, step-by-step implementation for single-PR tasks. Perfect for straightforward development tasks where you want a direct, step‑by‑step guide from idea to implementation.
- [Review Mode](https://docs.traycer.ai/extension/tasks/review.md): Agentic code review with thorough exploration and analysis. Perfect for comprehensive code quality checks where you want deep insights into implementation details, potential issues, and improvement opportunities.
- [Epic Mode](https://docs.traycer.ai/extension/tasks/epic.md): Collaborative artifact management through structured workflows. Perfect for managing specs and tickets with shared boards, real-time collaboration, and AI-guided development processes.
- [Collaboration](https://docs.traycer.ai/extension/tasks/collaboration.md): Share Epic boards with your team and collaborate in real time. Invite collaborators, assign tickets, and work together from requirements to implementation.
- [Workflows](https://docs.traycer.ai/extension/tasks/workflows.md): Create and manage structured development processes. Define custom workflows with commands that guide your team through your unique methodology.
- [YOLO Mode](https://docs.traycer.ai/extension/tasks/yolo-mode.md): YOLO Mode (You Only Look Once) automates your entire workflow. From intelligent orchestration that adapts at runtime to fixed-configuration automation, let Traycer handle planning, coding, and verification without manual intervention.
- [Mermaid Diagrams](https://docs.traycer.ai/extension/tasks/mermaid.md): Interactive workflow visualizations automatically generated with implementation plans, featuring copy and full-screen viewing options
- [Verification](https://docs.traycer.ai/extension/tasks/verification.md): Verify agent's implementation and manage review comments for iterative improvements. Traycer's verification process ensures that agent's implementation meet your requirements and follow your original plan. When issues are found, it generates actionable review comments that can be handed back to agen…
- [History](https://docs.traycer.ai/extension/tasks/history.md): Track, manage, and access your complete development history. Traycer automatically preserves and syncs the complete history of all your tasks and phases, allowing you to review, revert, or continue from any previous state, or any device.
- [AGENTS.md](https://docs.traycer.ai/extension/tasks/agents-md.md): Traycer automatically detects and uses AGENTS.md files to enhance AI task execution with project-specific context
- [Model Profiles and Cost Calculator](https://docs.traycer.ai/extension/tasks/models.md): Understanding model profiles, selection modes, and cost estimation.
- [Agents](https://docs.traycer.ai/extension/integrations/agents.md): Supported AI coding agents and how Traycer works with them. Traycer is designed to hand off clean and actionable prompts to your preferred AI coding agents.
- [Custom CLI Agents](https://docs.traycer.ai/extension/integrations/custom-cli-agents.md): Create custom CLI agents with custom arguments and permissions for any CLI-based coding agent.
- [Templates](https://docs.traycer.ai/extension/integrations/templates.md): Customize plan prompts with Handlebars templates for your coding agents
- [Model Context Protocol (MCP)](https://docs.traycer.ai/extension/integrations/mcp.md): Connect external tools and data sources to Traycer using MCP
- [Pricing & Usage Limits](https://docs.traycer.ai/extension/pricing.md): Understand credit-based pricing, plan credits, bundles, and billing details.
- [Extension Changelog](https://docs.traycer.ai/extension/changelog.md): Track updates and improvements to the Traycer IDE extension


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.