Docs/The Director/Overview
Director

The Director

3 min read

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 tabs above it: Terminal, Source Control, Voice, and History. 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.

Note
Closing your browser or putting your phone in your pocket never stops an agent - those are just views. The agents themselves run inside the Director on your machine. See keeping agents running for exactly what keeps going when.

Where to go next