quad-code
v0.1.3
Published
Mouse-first tmux dashboard CLI with a fixed 2x2 workspace.
Maintainers
Readme
quad code
quadcode is a CLI that opens a mouse-first 2x2 terminal dashboard in tmux.
Install
npm install -g quad-codeRun
quadcodeStart all four panes with opencode in the directory you launched from:
quadcode --opencodeYou can also run it without installing globally:
npx quad-codeWhat it does
- Starts a dedicated tmux server on socket
quadcode-dashboard - Creates one session named
quadcode-dashboardwith a fixed 2x2 tiled layout - Lets you click any pane to focus it and type directly into the real terminal there
- Lets you detach quickly with
F12 - Highlights the selected pane so it is easier to track at a glance
- Keeps the dashboard isolated from your normal tmux setup
- Can launch
opencodein every pane withquadcode --opencode
Requirements
- Node.js 20 or newer
tmuxinstalled and available on yourPATH- A Unix-like environment with tmux support, such as macOS or Linux
Notes
- The dashboard uses native tmux panes, so cursor rendering, shell prompts, and terminal apps behave like a real terminal.
- Pane switching is pure tmux mouse behavior with
mouse on. - Each
quadcodelaunch starts a fresh dedicated dashboard session. - Detaching leaves the current dashboard session running until the next launch replaces it.
