> ## Documentation Index
> Fetch the complete documentation index at: https://docs.traycer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Select a workspace folder, create your first Task, and run your first coding-agent chat.

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](/install).

<Note>
  This is the Desktop path. If you are using the IDE extension, use the [IDE Extension docs](/extension).
</Note>

## 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

<Steps>
  <Step title="Open Traycer Desktop">
    Launch Traycer and choose the workspace folder for the repository or project you want to work on.
  </Step>

  <Step title="Create a Task">
    A Task is the container for this piece of work. It can hold chats, terminal agents, files, git diff, and artifacts.
  </Step>

  <Step title="Start in Regular Mode">
    Use Regular Mode for the first chat. Regular Mode is direct coding-agent work with Traycer controls around it.
  </Step>

  <Step title="Describe the change">
    Ask for a small, concrete change or investigation. Keep the first run narrow so you can inspect the result easily.
  </Step>

  <Step title="Review the result">
    Use the File Tree and Git Diff panels inside the Task to inspect what changed.
  </Step>

  <Step title="Try Epic Mode for structured work">
    Switch to Epic Mode when the work needs planning, durable artifacts, tickets, or more careful intent preservation.
  </Step>
</Steps>

## 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.                       |
| **Regular Mode**     | Direct coding-agent work.                                    |
| **Epic Mode**        | Traycer's structured planning layer for artifact-heavy work. |
| **Artifact**         | A durable spec, ticket, story, or review inside a Task.      |

## Next Steps

<Columns cols={2}>
  <Card title="Learn the Concepts" href="/concepts/tasks-and-workspace-folders">
    Understand Tasks, panels, modes, and artifacts.
  </Card>

  <Card title="Use chats" href="/panels/chats">
    Understand permissions, model selection, attachments, voice input, and per-turn settings.
  </Card>

  <Card title="Plan work in Epic Mode" href="/concepts/modes">
    Use Traycer's planning layer for work that needs specs, tickets, stories, or reviews.
  </Card>

  <Card title="Set up Agents & Models" href="/agents-and-models/coding-agents">
    Configure Codex, Claude Code, OpenCode, Cursor, or Traycer.
  </Card>

  <Card title="Review changes" href="/panels/artifacts">
    Use git diff and review artifacts to inspect work before shipping.
  </Card>
</Columns>