QuadCode Help

Multi-Agent AI Terminal for macOS — User Manual

Getting Started

QuadCode lets you run up to 4 AI coding agents side-by-side in one app. Each pane is a fully independent terminal session.

Supported Agents

Claude — Anthropic's Claude Code CLI
Gemini — Google's Gemini CLI
Codex — OpenAI's Codex CLI
Aider — AI pair programming in your terminal
Copilot — GitHub Copilot CLI
Terminal — Plain shell (bash/zsh), no AI agent

To use an agent, it must be installed on your Mac. QuadCode auto-detects which agents are available and shows them in each pane's dropdown.

Pane Controls

Switching Agents

Click the agent dropdown in any pane's header bar to switch between available agents. The pane will restart with the selected agent.

Pane Colors

Click the colored circle next to the agent dropdown to pick a custom accent color for that pane. Colors persist across restarts.

Pane Titles

Click the title area (shows "TERMINAL 1" by default) to type a custom name. Titles persist across restarts.

Pinned Commands

Click the ⋮ button to open the pinned commands panel. Save up to 5 frequently used commands per pane — click any pin to run it instantly.

Layouts

Use the layout buttons in the header bar to switch between:

⊞ 4-pane grid — All 4 panes in a 2×2 grid
⬛⬛ Side by side — 2 panes horizontally
⬛ Stacked — 2 panes vertically
▣ Single — 1 pane maximized

Hidden panes keep their sessions alive — switch back anytime without losing your work.

Broadcast Mode

Press ⌘ B to toggle broadcast mode. A text bar appears at the top — type a command and it sends to ALL visible panes simultaneously. Perfect for running the same command across multiple projects.

Keyboard Shortcuts

Focus pane 1-4	⌘ 1-4
Restart current pane	⌘ R
Restart all panes	⌘ ⇧ R
Zoom / unzoom pane	⌘ Enter
Broadcast mode	⌘ B
Copy selected text	⌘ C
Paste from clipboard	⌘ V
Increase font size	⌘ +
Decrease font size	⌘ -
Reset font size	⌘ 0
Toggle full screen	⌃ ⌘ F

Tip: Right-click in any terminal pane for a context menu with Copy, Paste, Select All, and Clear Terminal options.

Licensing

Free Trial

QuadCode includes a 7-day free trial with full functionality. No credit card required.

Lifetime License

After the trial, purchase a lifetime license for $49 at getquadcode.com/activate. One payment, all future updates included.

Activating Your License

After purchase, you'll receive a license key via email. Enter it in the activation dialog within QuadCode. The app will restart automatically after activation.

License Details

Each license allows up to 2 Mac activations
License is tied to your machine — if you get a new Mac, contact support to transfer
License persists across app updates

Troubleshooting

Agent not showing in dropdown

The agent's CLI must be installed and accessible in your PATH. Install the CLI, restart QuadCode, and it will auto-detect.

Pane shows yellow dot (not connecting)

This usually means the agent's CLI binary doesn't have execute permissions. Try running in Terminal:

xattr -cr /Applications/QuadCode.app

Then restart QuadCode.

"Unidentified developer" warning

QuadCode is currently in beta and not yet notarized by Apple. To open it: right-click → Open → Done, then System Settings → Privacy & Security → Open Anyway.

Requirements

macOS (Apple Silicon or Intel)
At least one AI CLI installed (Claude, Gemini, Codex, or Aider)
Node.js (for some agent CLIs)

Support

Have a question, feature request, or found a bug?

Email: [email protected]
Website: getquadcode.com