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 chats, terminal agents, files, git diff, and artifacts.
3
Start in Regular Mode
Use Regular Mode for the first chat. Regular Mode is direct coding-agent work with Traycer controls around it.
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.
6
Try Epic Mode for structured work
Switch to Epic Mode when the work needs planning, durable artifacts, tickets, or more careful intent preservation.
What You Just Used
Next Steps
Learn the Concepts
Understand Tasks, panels, modes, and artifacts.
Use chats
Understand permissions, model selection, attachments, voice input, and per-turn settings.
Plan work in Epic Mode
Use Traycer’s planning layer for work that needs specs, tickets, stories, or reviews.
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.