nerd

Shells. Agents. You decide.

nerd is a terminal multiplexer for AI agents on macOS. Its sidebar shows which agent is working, which is waiting for you and which has finished.

curl -fsSL https://nerdterm.dev/install.sh | sh

macOS only, Apple Silicon prebuilt. Early 0.x software, MIT, open source.

your Mac

client

Your terminal window. Keys and mouse go in, the drawn screen comes out.

nerd server

Seatbelt sandbox: network denied

panes the pseudo-terminals and their screens

layout windows, splits, working directories

pane text written when the server stops

programs in panes

shell whatever you open

agents Claude Code, Codex, Gemini CLI and the rest

Run as you unless their isolation says otherwise.

plugins: a sandbox each

plugin shows

network no

writes its own folder

plugin writes

network no

writes folders it names

plugin network

network its named hosts

writes as declared

doors out, and the line each writes to daemon.log

gitgit clone …
curl to GitHubrelease check: …
sshremote: ssh …
a plugin with networkplugin … started: network …
plugin … proxy: …
pane proxypane N proxy: …
a link or a filelink opened …
the clipboardcopied N characters
Claude Code’s inboxmessage … via inbox: delivered

Pick a room or a door to see where its data goes.

Double wall: a sandbox. Single wall: runs as you, unless a pane’s isolation says otherwise. With sandbox set to false, or if the sandbox fails to start, the server is not kept off the network, and nerd --list and every window say so. Security

Start in a minute

Quick start

What it needs

  • macOS. nerd relies on macOS for its sandbox, clipboard, sounds, image conversion and login item. Linux and Windows are planned by the maintainer; pull requests for them are not accepted.
  • Apple Silicon for the prebuilt binary. Intel Macs can build from source; this is not tested.
  • Any terminal with mouse support and 24-bit colour.
  • Full-quality image previews need a terminal with the Kitty graphics protocol (Ghostty, Kitty, WezTerm, iTerm2). Elsewhere they are drawn in coloured blocks, and nerd says so under the image.
  • To build from source: Rust 1.88 or newer.
curl -fsSL https://nerdterm.dev/install.sh | sh

Or with Homebrew, upgraded with brew upgrade nerd:

brew install nerdterm/tap/nerd

Then run it

cd ~/code/my-project nerd

Then, with the mouse:

  • Right-click a pane and choose Split right or Split down.
  • Start an agent in a pane, for example claude. The sidebar shows its state. When it finishes or asks you something, it moves up into needs you.
  • Click ≡ at the top of the sidebar for the main menu: the file tree, new spaces, settings, plugins and the rest.
  • Right-click a pane and choose Isolation… to limit what its program can reach.
  • Close the window whenever you like. nerd brings it back; nerd --new starts another server with a desktop of its own.
  • Servers… in the main menu lists every server on this Mac, the one you are on first, and opens, renames, updates, stops and removes them. Machines you add to remotes in config.json are listed there too, over ssh, when you open them.

What nerd knows about your agents

Supported agents

Run nerd --install-hook once for exact states; it asks before writing into an agent’s config.

AgentConfigStates and needs youSubagentsResumes after a restart with
Claude Code~/.claude/settings.jsonYes, with the tool it asks forRows with their tools and runsclaude --resume=<id>
Codex~/.codex/hooks.jsonYes, with the tool it asks for; no failed callsRows, without a taskcodex resume <id>
Qwen Code~/.qwen/settings.jsonYes, with the tool it asks forRows with their toolsqwen --resume <id>
Copilot CLI~/.copilot/hooks/nerd.jsonYes, with the tool it asks forRows only; the general-purpose subagent does not reportcopilot --resume <id>
OpenCode~/.config/opencode/plugins/nerd.jsYesChild sessions as rowsopencode --session <id>
pi~/.pi/agent/extensions/nerd.jsYes, when an extension asks you something (a permission gate)None: its helpers are separate pi -p runspi --session <id>
Gemini CLI~/.gemini/settings.jsonYes, with the tool it asks forNone: it reports no subagentsgemini --resume <id>
Cursor~/.cursor/hooks.jsonYes; it asks no permission nerd can seeRows only: their tools count as the agent'sDoes not resume: starts fresh

Other agents are recognised by name, and their state is read from what they print. It can lag, be wrong, or miss "waiting for you".

What else is in it

Usage
  • See which agent needs you. nerd recognises Claude Code, Codex, Gemini CLI, Copilot CLI, Cursor, OpenCode, Qwen Code, pi and 13 other agents by their process name. With nerd's hook, those eight report their exact state, and most name the tool they ask to run; the others are read from what they print. nerd shows that an agent is asking; the answer stays yours, in the agent.
  • Decide what each pane can reach. A pane runs as you, with your files and your network, until you narrow it. Isolation… keeps a pane to its folder, to the hosts of the agents you choose, or to another macOS account. Messages between agents pass through nerd, under fixed limits and routes that only you change. A plugin shows what it can do before you install it.
  • See every way out of nerd's own code. No telemetry; nerd checks for updates only if you allowed it, and logs every check. The server runs in a macOS sandbox with networking denied. Every way out of nerd's own code is listed in What leaves nerd, starts from something you do or approved, and writes a line to the log.
  • A file tree beside the panes. It shows git changes, searches file contents, and previews files with highlighting and images; an SVG shows its picture, and a click on source in the preview's header its text; a PDF shows its first page and its page count.
  • One search for everything. ⌥+O finds a pane, a command, a setting, a plugin, a file, a help section or a line a pane printed earlier. Plain switches and installed plugins turn on and off in the result; anything that changes what a pane can reach opens its own window or Settings, never changes in place.

Plugins

all 2 in the catalog

A plugin adds previews, panels, top-row text, menu commands or tree marks. It runs in its own sandbox: it writes outside its own data folder, reaches the network and hooks into coding agents only where its manifest says, and you see that before you install it. What it can read is wider, as for any program you run: most of your files and the environments of your other programs.

Limits, said plainly

Install
  • nerd is early software (0.x). Configuration and behaviour may change between releases.
  • The binary is not notarized by Apple. The installer removes the download quarantine and Homebrew sets none; for an archive downloaded by hand, run xattr -d com.apple.quarantine nerd.
  • The installer adds ~/.local/bin to PATH in ~/.zshrc only. With another shell, add it yourself.
  • Inside tmux or screen, image previews fall back to coloured blocks: neither passes a graphics protocol on. In Ghostty, Kitty and WezTerm, nerd offers to open itself in a new window of the same terminal instead.
  • Exact agent states come from the hook, for the supported agents. For other agents the state is read from their output: it can lag, be wrong, or miss "waiting for you".
  • A hook that runs outside every pane's process tree is ignored, and that agent's state is read from its output. This covers Codex served by its shared background server (codex --no-daemon runs the hooks in its own pane) and an agent inside a tmux or screen started from a pane.
  • After a restart, pane text and layout come back; running processes do not. Pane text is lost if the server is killed with kill -9 or the Mac loses power.