terminal
Slot-addressed terminal control over tmux. Runs interactive commands, dev servers, test watchers, REPLs and TUI apps in numbered helper panes — beside the user or isolated from view — that the server places and owns, so an agent never holds a pane id or targets the user's own session.
| Version | 5.3.1 |
| Marketplace | magus |
| Commands | 9 |
| Subagents | 1 |
| Skills | 5 |
| MCP server | yes |
| Hooks | yes |
Install
magus
Find terminal on the Plugins tab and turn it on. magus registers the magus
marketplace if you do not have it, and installs what the plugin needs to actually run —
binaries, MCP servers, CLI tools.
For a team, press s to save your plugins as a profile and commit it. Everyone else runs
magus install — see Teams and profiles.
Prefer to do it by hand? Installing Magus has the manual path.
When to reach for it
- Use for psql, mongosh, redis-cli, python3, node, and other interactive shells —
repl - Use for raw keystrokes when /terminal:run, /terminal:repl, or /terminal:tui do not fit —
send - Use for dev servers, test watchers, log tailing, and builds —
watch - Use when monitoring terminal output for jest, vitest, pytest, go test, cargo, webpack, vite, or vercel —
framework-signals - Use when running interactive commands, starting dev servers, watching tests, querying databases, or working beside the user —
terminal-interaction - Use when navigating vim, nano, htop, less, psql, lazygit, k9s, tig, btop, or sending keystrokes to a database shell —
tui-navigation-patterns
Commands
| Command | What it does |
|---|---|
/terminal:help | Shows every terminal plugin command organized by use case, with guidance on which one to reach for and how slots work. |
/terminal:observe | Reads a slot without modifying it. Lists the slots you hold, captures a slot's recent output, or blocks until it exits, errors, or goes idle. |
/terminal:repl | Opens a REPL or database shell in an isolated slot, runs queries against its prompt, and closes the slot. Use for psql, mongosh, redis-cli, python3, node, and other interactive shells. |
/terminal:run | Runs a command in an isolated terminal pane, returns its output and exit code, and closes the pane. |
/terminal:send | Sends text or a named key to a slot and shows the result. Use for raw keystrokes when /terminal:run, /terminal:repl, or /terminal:tui do not fit. |
/terminal:slots | Lists the slots this session holds and closes one or all of them. Use to find a slot number after compaction, or to clean up panes left open by /terminal:watch, /terminal:repl, or /terminal:… |
/terminal:snapshot | Captures the current screen of a slot as text, with optional scrollback, or renders it as an image. Use to read raw pane content from a slot this session opened. |
/terminal:tui | Launches a TUI application such as vim, lazygit, htop, k9s, or tig in a slot and navigates it with keystrokes and screen reads. Delegates multi-step interaction to the tui-navigator agent. |
/terminal:watch | Starts a long-running process in a numbered slot, waits for readiness or failure, and reports the slot to check on later. Use for dev servers, test watchers, log tailing, and builds. |
Subagents
Dispatched with the Agent tool, each in its own context window.
| Agent | What it does |
|---|---|
terminal:tui-navigator | Use this agent for multi-step interactive terminal workflows -- navigating TUI apps (vim, htop, lazygit, psql, k9s), running interactive CLI tools, starting dev servers, running test watcher… |
Skills
| How you get it | |
|---|---|
| ● | Claude can reach for it on its own |
| ○ | You invoke it by name |
| ▸ | A command loads it for you — you never name it |
Why a skill lands in one row or another
| Skill | What it covers | |
|---|---|---|
| ● | terminal:tdd-workflow | Drives a Red-Green-Refactor state machine for TDD with terminal test watchers. Use when running TDD in watch mode or iterating on failing tests with jest, vitest, cargo watch, or pytest-watc… |
| ● | terminal:terminal-interaction | Slot-addressed tool patterns for interactive terminal access. Use when running interactive commands, starting dev servers, watching tests, querying databases, or working beside the user. |
| ● | terminal:tui-navigation-patterns | Provides key sequences and navigation patterns for common TUI apps. Use when navigating vim, nano, htop, less, psql, lazygit, k9s, tig, btop, or sending keystrokes to a database shell. |
| ○ | terminal:framework-signals | Provides pass/fail/running/idle output markers for 15+ test, build, and deploy tools. Use when monitoring terminal output for jest, vitest, pytest, go test, cargo, webpack, vite, or vercel. |
| ▸ | terminal:workspace-setup | Orchestrates tmux workspaces — dashboards, watch/entr monitors, one command on many hosts — on numbered helper slots. |
MCP server
This plugin runs an MCP server; its tools appear as mcp__* once the plugin is enabled.
Hooks
This plugin installs hooks. They run automatically and are the usual first place to look if its behaviour stops firing.
Source
plugins/terminal/ on GitHub, including its full README.