agex
Docs menuServers and keep awake

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 :5173 to 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

SettingDefaultWhat it does
keep_awake.displaytrueKeeps the display on too. Off lets it sleep while the Mac stays awake.
keep_awake.glowtrueThe warm glow around the window while it's on.
keep_awake.soundtrueA sound as it turns on and off, in step with the glow.
keep_awake.on_launchfalseTurns it on when agex starts.
status_bar.keep_awaketrueShows the coffee cup in the status bar.