Four terminals. One focused coding dashboard.
Quad Code is a mouse-first tmux dashboard CLI for running four coding sessions side by side in the folder you are already working in.
It creates a dedicated 2x2 workspace, lets you click panes to focus them, keeps terminal behavior native, and gives parallel tools like OpenCode, Codecs, Cloud Code, or your own shell room to work together.
Step 1
Run `quadcode` inside the repo you want to work in.
Step 2
Quad Code creates a dedicated tmux session with four tiled panes.
Step 3
Click the pane you want, type normally, and use F12 to detach.
Step 4
Use `QUADCODE_NO_ATTACH=1` when you want the dashboard left running in the background.
Dedicated socket
Runs on its own tmux socket instead of colliding with your usual setup
Mouse-first panes
Click to focus, keep typing, and stay in a visual multi-agent flow
Current-directory launch
Starts where you are, so the workspace matches the repo already under your hands
What it actually does
Quad Code launches its own tmux server and session so the dashboard stays separate from whatever tmux setup you already use.
Every run creates the same tiled 2x2 layout, which makes it easy to keep four coding agents or shells visible at once.
Because the panes are native tmux panes, shell prompts, terminal apps, and text rendering behave like a normal terminal session.
Click any pane to focus it, type directly, and detach with F12 when you want to leave the dashboard without killing it.
The dashboard starts in the directory where you run `quadcode`, which makes it natural to spin up a workspace inside the repo you are already in.
Quad Code inherits `SHELL` when it is set and falls back to `/bin/zsh`, so the panes feel like the terminal environment you expect.
How it fits real workflows
Pane 1 OpenCode
Pane 2 Codecs
Pane 3 Cloud Code
Pane 4 Your own shell for edits, logs, or gitKeep one pane for implementation, one for tests, one for logs, and one for review commands instead of constantly reusing a single terminal.QUADCODE_NO_ATTACH=1 quadcode
Leave the tmux session running in the background and attach later when you are in an interactive terminal.Commands
npx quad-codequadcodeQUADCODE_NO_ATTACH=1 quadcodeQuad Code uses a dedicated tmux session named `quadcode-dashboard`, titles the panes, enables mouse support, and binds `F12` to detach the client cleanly.
Node.js 20 or newer
tmux installed and available on PATH
macOS or Linux-style terminal environment
An interactive terminal for automatic attach, unless you use `QUADCODE_NO_ATTACH=1`
If you launch from a non-interactive environment, Quad Code explains that tmux attach needs a real terminal and points you to `QUADCODE_NO_ATTACH=1`.
Part of the Vorn toolset
Pair Quad Code with the rest of your workflow
Use Quad Code for multi-terminal execution, then layer in Vorn tools like Vorn Voice when you want to move faster through prompts, notes, and reviews.