Docs/Cockpit (browser)/Answering agents remotely
Cockpit

Answering agents remotely

3 min read

The point of the Cockpit is the moment you are not at your desk and an agent stops to ask a question. Instead of the work sitting idle until you get back, you open the Cockpit in whatever browser is in front of you, answer, and the agent keeps going. This page is that flow.

Answering from another machine

  1. Open the Cockpit

    From the Director, the Cockpit button in the toolbar opens the Cockpit in your default browser - use that the first time so you know the address. The address is your Gateway's: the hosted Gateway's public web address, or, if you self-host, your own machine on your own network.

  2. Sign in

    The Cockpit is yours, so it asks you to prove it. Sign in with your DevThrottle account; the browser stays signed in afterwards.

  3. Find the card that needs you

    The Cockpit reads exactly like the desktop: session cards with status colors. Switch the ordering to Attention first and the sessions waiting on you come to the top, under a Needs you heading with its own count. Click the waiting card.

  4. Answer in the prompt bar

    Type the answer (or a course correction) into the prompt bar, exactly as you would at your desk. The agent picks it up and keeps working.
Screenshot coming soonAnswering a waiting agent from the Cockpit prompt bar in a browser
Answering a waiting agent from the Cockpit prompt bar in a browser

Reachability: it depends on your Gateway

Your browser has to be able to reach your Gateway. With the hosted Gateway that is already true from everywhere: it is a public web address, and any browser on any network can open it. There is nothing to set up.

A self-hosted Gateway runs on your own machine, so reachability is your network's job. On the same network - home office laptop to the desktop upstairs - that just works. From further away, the supported route today is making your machine reachable yourself, for example with a VPN or an overlay network like Tailscale; the Gateway still handles who is allowed in. Your traffic goes to your machine either way - DevThrottle does not relay it. Which Gateway you run is a choice made at setup; see the Gateway.

Tip
If what you really want is the answer-from-anywhere experience with a ping when an agent needs you, that is the mobile app - it pairs your phone to the Gateway once and then notifies you.
Note
A session you start from the Cockpit runs in the Director on the machine you pick when you start it - the Cockpit is a view, not the place the work runs. The same steering controls - Stop, Interrupt, and the queue - are available remotely.