The Director

The Director is the DevThrottle desktop app - the Director you keep open while your coding agents work. Every agent session is a card in the left sidebar; the selected session fills the rest of the window with a full terminal, so you are never more than one click from the raw agent. This page is a tour of the window; the rest of the section goes deeper on cards and states, steering, source control, and settings.

The layout

The window has three working areas:

• The session sidebar on the left. One card per agent session, each with a colored status square that tells you at a glance whether that agent is working or waiting on you. A counter at the top of the rail shows how many sessions need you right now. Cards can be dragged into your own order and collapsed to a slim strip of status dots when you want the space.
• The session pane in the center. The selected session's terminal, exactly as the agent sees it, with two tabs above it: Terminal and Source Control. Source Control appears only when the session's folder is a git repository. A right panel holds Screenshots (images you send from your phone) and the Queue of prompts waiting their turn.
• The prompt bar at the bottom. Type a message and send it into the terminal, queue it for later, or dictate it with the Speak button. The steering page covers every control.

The toolbar

Across the top: New Session (Ctrl+N) starts an agent; Cockpit opens the same fleet in your browser; Settings opens the Director settings. The status rail at the bottom of the sidebar shows the health of the Gateway connection - one chip that also tells you whether you are signed in - the bundled tools, and auto-update.

A view, backed by a service

The Director runs your agent sessions, and the Gateway keeps the whole setup reachable. By default that is DevThrottle's hosted Gateway - your account joins it, and there is nothing to run yourself - though you can run your own instead. Either way it serves the Cockpit to your browser and phone, runs scheduled agent runs, and can have a Director started on your machine when a schedule fires. You watch the Director; the plumbing stays out of sight.

Where to go next

• Session cards and states - read the Director at a glance.
• Starting and steering agents - the New Session dialog, the prompt bar, and the queue.
• Start your first session - if you have not started one yet.