Docs/The board (Director)/Settings
Director

Director settings

4 min read

Open settings with the Settings toolbar button, or File - Settings (Ctrl+comma). The dialog is organized into six tabs: Account, Gateway, Agents, Directories, Advanced, and Tools.

Screenshot coming soonThe Director Settings dialog with its Account, Gateway, Agents, Directories, Advanced, and Tools tabs
The Director Settings dialog with its Account, Gateway, Agents, Directories, Advanced, and Tools tabs

Account

A read-only view of your DevThrottle account: the Gateway it connects through and who is signed in. Sign-in itself is handled centrally by the Gateway - one sign-in per machine, and every Director on it inherits it - so there is deliberately no sign-in or sign-out button here. Manage the account from the Cockpit.

Gateway

How this Director finds its Gateway: the Gateway URL (with Detect and Test buttons), the Director's own public URL, and an optional Gateway token for setups where the Gateway requires one explicitly. This tab is also where you pair devices (Connect to Gateway...) and where Re-run setup wizard... lives if you want the first-run experience again.

Agents

The list of coding agents that appear in the New Session dialog. Each entry has a display name, a type, an enabled checkbox, an order (which sets the order of the radio buttons when you start a session), and a status pill showing whether the agent's command checked out. Add Agent creates an entry by hand; the Detection wizard scans the machine for installed agents and offers to add what it finds.

Note
Claude Code and Pi ship with verified drivers and are always available. Other agents are added here as their drivers are verified.

Directories

Where screenshots land. Images you send from your phone are saved to this folder and appear in the session's Screenshots panel; Detect finds the default location and Browse picks another.

Advanced

Two cards. Network and Firewall pre-authorizes the app with Windows Firewall so you do not get the pop-up the first time another device connects. Alpha Features is a single checkbox, off by default, that reveals experimental features still being verified. This documentation covers the product with the checkbox off.

Tools

DevThrottle ships a set of command-line helper tools (the cc-* tools) that agents can use. This tab shows their status, offers Download and repair tools, and has an Automatically keep cc-* tools up to date checkbox - on by default, so the tools stay current without you thinking about them.

Tip
The footer of the dialog has an Open config.json link - the file behind every setting, for when you want to see or script the raw configuration.

Machine settings live in the Cockpit

Settings that belong to the machine rather than to one Director window are on the Cockpit's Settings page (open Cockpit from the toolbar). That is where you choose the machine's AI provider for DevThrottle's own features such as voice transcription: your DevThrottle account (the default - usage is paid from your prepaid credits), or your own OpenAI API key, which is stored on your machine and never sent to DevThrottle. The Cockpit Settings page also controls whether the Gateway starts when you log in, and how devices address each other on your network.