Quorum Terminal organizes your work around a few stable ideas: a workspace you open, the terminals you run inside it, the AI sessions those terminals host, and the panels and context files that support them. Understanding how these fit together is the fastest way to feel at home.
Workspaces
A workspace is a project folder you open in Quorum Terminal. Settings persist per project, so each codebase keeps its own configuration rather than sharing one global state. Open a folder and its preferences travel with it the next time you return.
Terminals and surfaces
A terminal is an independent shell session. Quorum Terminal supports up to 32 terminals per project; new installs default to a 16-terminal limit, which you can raise to 24 or 32 in Settings.
How those terminals are arranged is the surface:
| Surface | Layout |
|---|---|
| Grid | Tiled terminals, from 1x1 up to 4x4 |
| Sessions | One focused active terminal plus a scan-first list of the others, with each row showing its status |
Grid is best when you want several terminals visible at once. Sessions is best when you want to drive one terminal while monitoring the rest at a glance.
Sessions
A session is an AI agent run, tracked with metadata such as its branch, model, estimated cost, age, and activity. When a session ends it is archived rather than discarded, and you can resume an archived session to continue where it left off.
The right dock
The right dock is a vertical icon rail that opens tool panels next to your terminals:
- History
- Saved Prompts
- Plugins
- Source Control
- Usage
Each icon toggles its panel, keeping these tools one click away without crowding the terminal area.
Context files
Quorum Terminal autoloads AGENTS.md from the repository root and wires CLAUDE.md to it, so agent instructions survive across sessions and reloads without you re-explaining the project each time. Keep companion files like STRUCTURE.json and PROJECT_NOTES.md in the same root as your project's living map — your AGENTS.md can point agents at them.
Keep these files in the repo root so they are picked up automatically.
Something off on this page? Tell us.