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.

Supported Agents

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.

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:

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

Broadcast Mode

Press ⌘ B (macOS) or Super B (Linux) 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

macOSLinux
Focus pane 1-4⌘ 1-4Super 1-4
Restart current pane⌘ RCtrl R (pane focused) or Super R
Restart all panes⌘ ⇧ RSuper ⇧ R
Zoom / unzoom pane⌘ EnterCtrl Enter (pane focused) or Super Enter
Broadcast mode⌘ BSuper B
Copy selected text⌘ CRight-click → Copy
Paste from clipboard⌘ VCtrl V
Increase font size⌘ +Super +
Decrease font size⌘ -Super -
Reset font size⌘ 0Super 0
Toggle full screen⌃ ⌘ FUse your window manager (no app shortcut yet)

Super is the key with the Windows or ⌘ logo. On macOS, Ctrl also works in place of ⌘ for every shortcut above. Linux shortcuts verified against QuadCode 1.0.12 for Linux.

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 $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.

License Details

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.0.12-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.0.12-x86_64.AppImage --no-sandbox to see the error.

Linux: install or remove the .deb package

Install: sudo apt install ./quadcode_1.0.12_amd64.deb  ·  Remove: sudo apt remove quadcode

Requirements

Support

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