This walkthrough takes you from an empty window to a running AI agent in a few minutes. Open a project, pick a terminal surface, start your tool, and branch out from there.
Open a project
Add a project folder in Quorum Terminal. The workspace opens with a file tree on one side and a terminal surface on the other.
Pick the terminal surface that fits how you work:
- Grid — tiled terminals, all visible at once.
- Sessions — one focused active terminal plus a list of your other sessions.
Start your first agent
Select your AI tool — Claude Code, Codex, or Gemini — then press ⌘ K to start the
selected AI tool in the active terminal. The agent runs inside that terminal, with your
project folder already as its working directory.
| Shortcut | Action |
|---|---|
⌘ K | Start the selected AI tool |
⌘ ⇧ T | New terminal |
⌘ ⇧ N | New terminal or split the active one |
Work across terminals
Once your first agent is running, spread out:
- Press
⌘ ⇧ Tto open another terminal, or⌘ ⇧ Nto open one or split the active terminal. - Drag a file from the file tree into a terminal to drop its path at the cursor — handy for pointing an agent at a specific file.
- Open the git panel to review changes as the agent edits your code.
Tip: drag a path straight into a running agent prompt instead of typing it out.
Next steps
From here, three pages go deeper: Core concepts explains workspaces, surfaces and sessions; AGENTS.md shows how Quorum Terminal keeps agent context alive across sessions; and Keyboard shortcuts is the full cheatsheet.
Something off on this page? Tell us.