AGENTBØY

A retro handheld-console terminal designed for AI pair programming.
Real PTYs, approval dialogs, git undo checkpoints — in a Game Boy shell.

GitHub npm Linux · X11 MIT License Electron + xterm.js
agentboy terminal, Agentboy DMG dark theme
# requires Node.js 20+, python3/make/g++ for node-pty
$ npm install -g agentboy
$ agentboy

Workflow

BUILT FOR AI AGENTS

 

OSC 98 approval dialog with YES / NO / DIFF buttons

OSC 98 approval flow

Agents ask for permission with an escape sequence: OSC 98 ; prompt=… pops a retro RPG dialog with YES / NO / DIFF, git-checkpoints the pane's working directory on YES, opens the Diff Inspector on DIFF, and answers y/n back to the shell.

split panes

Split panes, real PTYs

Terminator-style splits — every pane runs its own PTY, with draggable dividers, search, and X11 CLIPBOARD + PRIMARY support. Undo checkpoints roll back the last AI edit with one right-click.

ACTION status LED

ACTION status LED

A traffic light on the chassis shows what's happening at a glance — and turns red when the agent prints a numbered option menu or a y/n question and waits on you.

idle typing agent output needs you

Chassis & screen

EIGHT THEMES · DARK & LIGHT

Agentboy DMG theme, dark

Agentboy DMG — the classic pea-soup phosphor, dark.

Extras

EXTRAS

 

cmatrix screensaver

cmatrix screensaver

F10 SAVER starts cmatrix in an overlay on its own PTY. Any key or click exits. Install it with sudo apt install cmatrix.

frameless mode

NOFRAME mode

F8 NOFRAME hides the whole chassis for a bare, distraction-free terminal. The keyboard F11 key or the right-click menu brings the shell back.

Speakers & built-in tune

Two round speakers by the A/B buttons: one plays Phosphor Drift, a cozy lofi tune with a brown-noise rain bed, composed for agentboy (the speaker glows while it plays), the other gates the sound effects — all of them derived from the tune itself: D-major pentatonic, soft triangle waves, plus a whisper-quiet typing tick.

Chassis controls

F1dark / light (right-click: git undo)
F2chassis frame style (right-click: divider style)
F3 / F4previous / next theme
F5–F7CRT mode (mask / grille / glass / off) & intensity
F8noframe — hide the chassis
F9expand over the toolbar
F10cmatrix screensaver
F11 / F12float mode / scroll to bottom
B / Afull-height column / snap to grid