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
git clone …release check: …remote: ssh …plugin … started: network …
plugin … proxy: …pane N proxy: …link opened …copied N charactersmessage … via inbox: deliveredPick 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 startWhat 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
nerdThen, 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.
nerdbrings it back;nerd --newstarts 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
remotesin config.json are listed there too, over ssh, when you open them.
What nerd knows about your agents
Supported agentsRun nerd --install-hook once for exact states; it asks before writing into an agent’s config.
| Agent | Config | States and needs you | Subagents | Resumes after a restart with |
|---|---|---|---|---|
| Claude Code | ~/.claude/settings.json | Yes, with the tool it asks for | Rows with their tools and runs | claude --resume=<id> |
| Codex | ~/.codex/hooks.json | Yes, with the tool it asks for; no failed calls | Rows, without a task | codex resume <id> |
| Qwen Code | ~/.qwen/settings.json | Yes, with the tool it asks for | Rows with their tools | qwen --resume <id> |
| Copilot CLI | ~/.copilot/hooks/nerd.json | Yes, with the tool it asks for | Rows only; the general-purpose subagent does not report | copilot --resume <id> |
| OpenCode | ~/.config/opencode/plugins/nerd.js | Yes | Child sessions as rows | opencode --session <id> |
| pi | ~/.pi/agent/extensions/nerd.js | Yes, when an extension asks you something (a permission gate) | None: its helpers are separate pi -p runs | pi --session <id> |
| Gemini CLI | ~/.gemini/settings.json | Yes, with the tool it asks for | None: it reports no subagents | gemini --resume <id> |
| Cursor | ~/.cursor/hooks.json | Yes; it asks no permission nerd can see | Rows only: their tools count as the agent's | Does 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.
⌥+Ofinds 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 catalogA 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/bintoPATHin~/.zshrconly. 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-daemonruns 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 -9or the Mac loses power.