Workspace
Servers and keep awake
How agex finds the servers your agents and terminals start, how to open and stop them, and how to keep your Mac awake.
When your agents or terminals start dev servers, agex lists their ports so you can open them in a click, and stop them when you're done.
What counts as a server
agex lists a server when it runs:
- Under one of agex's agents or terminals.
- Under an agent running elsewhere in the project.
- In the project's folder, after an agent started it in the background and let it go (
nohup npm run dev &). It counts for as long as it runs.
An agent's own sockets don't count.
Where servers are listed
Servers show up in two places:
- In the sidebar. The row of each agent or terminal shows the ports of the servers it started. Click
:5173to open it in the browser. - In the status bar. The right side lists the project's servers:
● localhost:5173, or● 3 servers ▾once there are several.
With the Session panel on, only the sidebar rows show them.
The status bar's list has a row per port, showing:
- Who started it: the agent's logo, a terminal, or neither, for a server running on its own.
- The folder it runs in.
- Its command.
- Its address.
To hide the servers from the status bar, turn off status_bar.servers.
Open or stop a server
- Click a row in the list to open the server in the browser.
- Click ■ on a row to stop it.
Keep awake
The coffee cup at the far right of the status bar keeps your Mac awake while your agents work. Click it to turn it on, and click it again to let the Mac sleep. Hover the cup to see how long it has been on.
You can also toggle it from the menu bar icon and the command palette (⇧⌘P).
What it runs
The cup runs macOS's caffeinate -dis, so neither the display nor the system sleeps. macOS only lets it hold off system sleep on AC power.
To let the display sleep while the Mac stays awake, turn off keep_awake.display.
How it looks
While it's on, steam rises from the cup and the window warms up. The color rolls out from the cup across the window, then settles into a warm glow along the edges that breathes slowly. Turning it off plays that backwards: the far edges go dark first, and the color draws back into the cup.
The glow sits behind the chrome (the top bar, rail, sidebar and status bar), so terminals and editors keep their own colors. A sound plays as it turns on and off, in step with the glow.
When it stops
Keep awake stops when you quit agex, even if agex crashes. It starts off on each launch, unless you turn on keep_awake.on_launch.
Keep awake settings
| Setting | Default | What it does |
|---|---|---|
keep_awake.display | true | Keeps the display on too. Off lets it sleep while the Mac stays awake. |
keep_awake.glow | true | The warm glow around the window while it's on. |
keep_awake.sound | true | A sound as it turns on and off, in step with the glow. |
keep_awake.on_launch | false | Turns it on when agex starts. |
status_bar.keep_awake | true | Shows the coffee cup in the status bar. |