Quickstart

Select a workspace folder, create your first Task, and run your first agent.

This guide gets you from a fresh Traycer install to one useful coding-agent interaction. If you have not installed Traycer yet, start with Install.

This is the Desktop path. If you are using the IDE extension, use the IDE Extension docs.

Before You Start

You need:

• Traycer installed.
• A local code folder you want Traycer to work with.
• At least one coding agent path available.

First Run

1. Open Traycer Desktop

   Launch Traycer and choose the workspace folder for the repository or project you want to work on.

2. Create a Task

   A Task is the container for this piece of work. It can hold agents, terminals, files, git diff, and artifacts.

3. Start your first agent

   Pick a coding agent and model, then describe what you want. Traycer keeps the work connected to the Task, workspace, files, and artifacts.

4. Describe the change

   Ask for a small, concrete change or investigation. Keep the first run narrow so you can inspect the result easily.

5. Review the result

   Use the File Tree and Git Diff panels inside the Task to inspect what changed.

What You Just Used

Thing	What it means
Workspace folder	The local code folder Traycer is working against.
Task	The top-level container for this work.
Artifact	A durable spec, ticket, story, or review inside a Task.

Next Steps

Learn the Concepts

Understand Tasks, panels, and artifacts.

Work with agents

Understand the Chat and Terminal interfaces, permissions, model selection, attachments, voice input, and per-turn settings.

Set up Agents & Models

Configure Codex, Claude Code, OpenCode, Cursor, or Traycer.

Review changes

Use git diff and review artifacts to inspect work before shipping.