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.
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.
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.
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.