Start
Introduction
What agex is, the problem it solves, a tour of its main areas, and what you need to run it.
agex is a Mac app that gives your projects and the coding agents you run in them one terminal workspace. You add project folders, start agents such as Claude Code, Codex or Gemini CLI in tabs, and agex keeps track of what each one is doing. It's built with GPUI and alacritty_terminal.
Why agex
Running one agent in one terminal is easy. Running six across four projects is not: one finished ten minutes ago, another has been waiting for a yes or no since lunch, and a third quietly failed. You find out by clicking through tabs and windows.
agex reads each agent's state and puts it where you can see it at a glance:
- Every agent has a ring that shows whether it's working, done, waiting for your answer, failed or idle.
- Project tiles carry a dot when an agent there needs you, is working or has news.
- The top bar counts agents by state across every project, and the Dock icon and menu bar icon show how many are waiting on you.
- ⌘J jumps to the agent that has waited longest, in any project.
- When an agent asks a question, its options appear in the sidebar, so you can answer without switching tabs.
This works for agents you start in agex and for agents you started somewhere else, like Terminal, iTerm2, tmux or an editor.
A tour of the window
| Area | What it does | Read more |
|---|---|---|
| Project rail | One tile per project folder, with the project's own icon and a dot for agents that need you. | Projects |
| Sessions sidebar | The project's agents, then its terminals and past sessions. | Agents |
| Panes | Terminals, agents, editor tabs and diffs, in cards you can split and rearrange. | Editor and panes |
| Right panel | Source control, files, search, notes and, optionally, the session view. | Source control, Files and search, Notes |
| Status bar | The context window and prompt cache of the agent in front, the project's servers, and the keep-awake cup. | Context and cache, Servers and keep awake |
| Top bar | Agent counts, Open in, the Scripts menu, panel toggles and the Update button. | Projects, Updates |
agex also adds an agex command to your PATH, so you can list agents, start them, wait for them and edit your to-dos from any terminal. See Command line.
Agents it supports
agex recognizes 30 agent CLIs, including Claude Code, Codex, Gemini CLI, GitHub Copilot CLI, Cursor Agent, OpenCode, Amp and Aider. Only the ones installed on your Mac show up. How much agex can read from each one varies; see Supported agents for the full list and what works with each.
Requirements
- A Mac with Apple silicon.
- macOS 11 or later.
- The agent CLIs you want to use, installed so your login shell can find them.
git, for source control. agex runs your own copy.
To get started, download and install agex, then follow the quickstart.