QuadCode Help
Multi-Agent AI Terminal for macOS & Linux — 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. The default working folder is ~/QuadCode.
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, its CLI must be installed on your computer and on your PATH. 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.
Working Folder
Each pane has its own working folder. The folder button in the pane header shows the pane's live working folder name and follows cd in the shell (checked every 2 seconds). The tooltip shows the full path and, when it differs, the start folder that new sessions in that pane use. Click the button to pick a folder (or choose Change Working Folder… from the right-click menu). The pane restarts there, and that pane's agent starts in the folder you chose. The default is ~/QuadCode.
Saved Snippets
Click the ⋮ button at the top right of a pane to open Saved snippets (also called pinned commands). Save up to 5 frequently used commands per pane — click any snippet to run it instantly.
Export or Copy a Transcript
Export a pane's terminal history to a text file, or copy it, from the right-click menu (Export Transcript… or Copy Transcript) or the export button in the pane header.
Restore After Quit or Update
After you quit or install an update, QuadCode restores your layout, the zoomed and focused pane, and each pane's agent, title, color, saved snippets, broadcast include/exclude, and working folder, then starts each agent in its folder. If a saved agent is no longer installed, QuadCode falls back to an installed one.
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 (macOS) or Ctrl+Shift+B (Linux), use Broadcast to All Panes in the View menu, or click the Broadcast button in the header. A text bar appears at the top — type a command and it is sent to every included pane.
Each pane has a B button. Click it to include or exclude that pane. The bar says “Sending to N included panes.” A pane with a dim B is excluded and will not receive broadcasts.
Jump to a Waiting Pane
When a pane finishes a long agent run and goes quiet, or when the agent asks a question or for permission, it can show a needs you badge. Real questions include “Do you want to…”, “(y/n)”, “Press Enter”, a numbered choice, or a password prompt. A busy agent (for example “esc to interrupt”), or a shell command that is still running and printing nothing, does not raise the badge. The header can show N waiting. Press ⌘J (macOS) or Ctrl+Shift+J (Linux), or click the bell button in the header, to jump to a waiting pane. Press or click again to cycle through several. Panes hidden by the layout or by a zoomed pane are brought into view.
If QuadCode is in the background, it bounces its Dock icon on macOS, or flashes its taskbar entry on Linux, when a pane finishes a long agent run or is waiting for you. Dock bounce ships in QuadCode 2.1.2 and later for macOS. Taskbar flash and the Linux jump shortcut ship in Linux 1.1.0 and later; the current public Linux download is 1.1.5.
Keyboard Shortcuts
| macOS | Linux | |
|---|---|---|
| Focus pane 1-4 | ⌘ 1-4 | Ctrl Shift 1-4 |
| Restart current pane | ⌘ R | Ctrl Shift R |
| Restart all panes | ⌘ ⇧ R | Ctrl Alt Shift R |
| Zoom / unzoom pane | ⌘ Enter | Ctrl Shift Enter |
| Broadcast to included panes (show/hide bar) | ⌘ ⇧ B | Ctrl Shift B |
| Jump to the pane that needs you | ⌘ J | Ctrl Shift J |
| Copy selected text | ⌘ C | Ctrl Shift C |
| Paste from clipboard | ⌘ V | Ctrl Shift V |
| Increase font size | ⌘ + | Ctrl + |
| Decrease font size | ⌘ - | Ctrl - |
| Reset font size | ⌘ 0 | Ctrl 0 |
| Toggle full screen | ⌃ ⌘ F | F11 |
| Saved snippets (pinned commands) | ⋮ in pane header | ⋮ in pane header |
| Copy / export transcript, change folder | Right-click pane | Right-click pane |
The Linux column matches Linux 1.1.5, the current public Linux download.
Updates
Check for Updates… is in the QuadCode menu on macOS and the Help menu on Linux. The check runs immediately and says whether you are up to date, whether an update was found, or why the check failed.
A download dialog with a progress bar appears while an update is downloading, including the automatic check a few seconds after launch. It shows percent and transferred size when the download reports them. When the download is ready, Restart & Update stays on the green banner and in the dialog.
After an in-app update, a What’s New dialog lists what changed in that version. Acknowledge it with OK. It appears once for that version.
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 $9.99 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.
Activating Offline (No Internet)
If the computer can’t reach the internet, open Enter License Key and choose No internet on this computer? Activate offline (macOS 2.1.5 and Linux 1.1.5 or later). QuadCode shows a machine code: copy it or save it to a file. On any device that is online, go to getquadcode.com/offline, enter your license key and the machine code, and download the license. Back on the offline computer, paste the license or import the file in the same dialog. An offline license is tied to that one computer, uses one of your device activations, and lasts a year; a banner appears in its last 30 days, and you renew it the same way. Computers that are online keep activating automatically, and existing licenses keep working without re-entering a key.
License Details
- Each license allows up to 2 device activations (Mac, Linux, or Windows)
- License is tied to your machine — if you get a new machine, contact support to transfer
- A license already saved on this Mac or Linux machine carries across app updates without asking you to re-enter the key
- Invalid, revoked, or missing keys are still refused
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.
macOS security warning on first launch
QuadCode for macOS is signed and notarized by Apple, so it should open normally. If macOS still shows a warning (usually after an incomplete download), download the DMG again from getquadcode.com/download.html. If it persists: right-click QuadCode → Open → Open, or System Settings → Privacy & Security → Open Anyway.
Linux: AppImage won't start
Make it executable first: chmod +x QuadCode-1.1.5-x86_64.AppImage. On Ubuntu 22.04 and newer, AppImages also need FUSE 2: sudo apt install libfuse2. If it still won't launch, run it from a terminal with ./QuadCode-1.1.5-x86_64.AppImage --no-sandbox to see the error.
Linux: install or remove the .deb package
Install: sudo apt install ./quadcode_1.1.5_amd64.deb · Remove: sudo apt remove quadcode
Requirements
- macOS 13 (Ventura) or later on Apple Silicon (M1 or newer), Linux x86_64 (AppImage or .deb), or Windows 10/11 (x64). Intel Macs are not supported. The Windows installer is unsigned; if SmartScreen appears, click More info, then Run anyway.
- 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