First run and importing

This page walks through the first time you open Traycer Desktop. If you haven’t installed it yet, start with Install.

​

Sign In

The app opens on Welcome to Traycer. Click Sign in and approve the sign-in in your browser. If the browser doesn’t open, expand Use code instead and approve the sign-in with a code from any browser. See Sign in.

​

Setting Up Traycer

On the first launch, Traycer sets up this computer’s host, the background service that runs your agents. The app shows Setting up Traycer: “Traycer is getting this machine’s host ready. This runs once, and the app opens as soon as it’s done.” Progress reads “Starting Traycer…”, then “Downloading Traycer Host…” and “Setting up Traycer Host…”. If setup doesn’t finish, see Troubleshooting. To learn what the host does, see Hosts.

​

The Introduction

A short introduction follows “Welcome to Traycer.” It has three steps: Click Continue or press Enter to move on, and Back to go back. Skip intro skips the rest. On the Import step, Skip for now finishes without importing; after an import starts, the button reads Start building. To see the introduction again, use Initial tour in Getting started.

​

Import Your Work

Import your work turns sessions you already ran in Claude Code, Codex or OpenCode into Traycer Tasks, so you can pick them up here. It reads the sessions stored on the host’s machine. Open it from:

• The Import step of the introduction.
• Settings › Host › Overview › Data › Import your work › Import. The import runs on the host that Settings is showing.

What you get:

• Sessions from the same repository land together in one Task, as one agent per session, with the whole conversation.
• Imported Tasks sort by when the work happened, not by when you imported it.
• A new imported Task shows a dot until you open it (“Imported from … - not opened yet”).
• Open the Task and send a message to keep going. The composer starts on the agent the session came from.

Some sessions can’t be imported, for example when a session can’t be read or has no messages. The list marks sessions it can’t read as “Unreadable”, and after an import Traycer says which sessions weren’t imported and why.

​

Your First Task

After the introduction, a short guide points at the start page:

1. Pick a project. Add the folder Traycer should work in.
2. Choose where it runs. Local, a new worktree, or an existing one.
3. Give it a task. Describe what to build or debug, then press Enter.

If you imported sessions, the guide shows you where your Tasks are instead, then how to continue one. When the guide ends, a notification reads “You’re all set — More setup is in Settings.” Click Open to go to Getting started. For a full walkthrough of the first Task, see Quickstart.

​

Getting Started Checklist

Your setup checklist sits at the top of the Home tab, and in Settings › Getting started. It replays the introduction (Initial tour) and runs three guides on the real settings:

• Agent selection: choose how agents delegate work.
• Appearance and layout: theme, start page, fonts and layout.
• Browser sign-ins: bring your website sign-ins from another browser into Traycer’s browser. Desktop app only, and it needs a connected host.

On Home, the checklist stays open with its cards while any guide is left, with a count such as “2 of 4 complete”. Once every guide is done, it folds into a single Getting started row marked ✓, which starts closed each time you open Home; expand it to revisit a guide. Home leaves out a guide this app can never offer, such as Browser sign-ins outside the desktop app, and doesn’t count it. Settings and Home show the same cards and the same progress.

​

Where To Go Next