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

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:

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

macOSLinux
Focus pane 1-4⌘ 1-4Ctrl Shift 1-4
Restart current pane⌘ RCtrl Shift R
Restart all panes⌘ ⇧ RCtrl Alt Shift R
Zoom / unzoom pane⌘ EnterCtrl Shift Enter
Broadcast to included panes (show/hide bar)⌘ ⇧ BCtrl Shift B
Jump to the pane that needs you⌘ JCtrl Shift J
Copy selected text⌘ CCtrl Shift C
Paste from clipboard⌘ VCtrl Shift V
Increase font size⌘ +Ctrl +
Decrease font size⌘ -Ctrl -
Reset font size⌘ 0Ctrl 0
Toggle full screen⌃ ⌘ FF11
Saved snippets (pinned commands)⋮ in pane header⋮ in pane header
Copy / export transcript, change folderRight-click paneRight-click pane

The Linux column matches Linux 1.1.5, the current public Linux download.

Tip: Right-click in any terminal pane for Copy, Paste, Select All, Clear Terminal, Copy Transcript, Export Transcript…, and Change Working Folder…

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

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

Support

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