terminal
Intent-level terminal control over tmux. Runs interactive commands, dev servers, test watchers, REPLs and TUI apps, and refuses to send keys into a pane that already has a process in the foreground.
| Version | 4.1.6 |
| Marketplace | magus |
| Commands | 9 |
| Subagents | 1 |
| Skills | 5 |
| MCP server | yes |
| Hooks | yes |
Install
claudeup
Find terminal on the Plugins tab and turn it on. claudeup 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
claudeup install — see Teams and profiles.
Prefer to do it by hand? Installing Magus has the manual path.
When to reach for it
- use when —
help - Use for dev servers, test watchers, log tailing, and build processes —
watch - Use when monitoring terminal output for jest, vitest, pytest, go test, cargo, webpack, vite, or vercel —
framework-signals - Use when navigating vim, nano, htop, less, psql, lazygit, k9s, tig, btop, or sending keystrokes to a database shell —
tui-navigation-patterns - Use when setting up a project session, building a multi-pane dashboard, or syncing panes —
workspace-setup
Commands
| Command | What it does |
|---|---|
/terminal:help | Show all available terminal plugin commands organized by use case, with guidance on which command to use when. |
/terminal:observe | Observe running terminal sessions without modifying them. List active sessions, capture pane content, check on dev servers or test watchers started earlier. |
/terminal:repl | Open an interactive REPL or database shell session. Handles prompt detection, query execution, and clean exit for psql, mongosh, redis-cli, python3, node, and other REPLs. |
/terminal:run | Run a command in an isolated terminal session, capture output, and auto-cleanup. Use instead of Bash when you need TTY, interactive prompts, or screen-rendered output. |
/terminal:send | Send keystrokes or text to an active terminal session. |
/terminal:session | Manage terminal sessions -- create, list, or close tmux and headless sessions. |
/terminal:snapshot | Take a snapshot of a terminal pane to see its current screen content. |
/terminal:tui | Launch and navigate TUI (terminal user interface) applications like vim, lazygit, htop, k9s, tig. Delegates to the tui-navigator agent for multi-step interaction. |
/terminal:watch | Start a long-running process in a terminal session, monitor for readiness or failure, and report status. Use for dev servers, test watchers, log tailing, and build processes. |
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 |
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 | Provides tmux-mcp tool API patterns for interactive terminal access. Use when running interactive commands, starting dev servers, watching test output, querying databases, or splitting panes… |
| ● | 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:workspace-setup | Orchestrates tmux workspaces — sessions, dashboard layouts, watch/entr monitors, synced panes. Use when setting up a project session, building a multi-pane dashboard, or syncing panes. |
| ○ | 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. |
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.