terminal-commander
v0.1.79
Published
Terminal Commander: local MCP-operated terminal/file signal channel with native Linux, Windows, and macOS packages.
Maintainers
Readme
terminal-commander
npm root wrapper for Terminal Commander, a local MCP control plane for coding agents.
Install
npm install -g terminal-commander@latestInstall is passive: no lifecycle bootstrap, no automatic MCP config writes, no daemon start, no WSL install, and no hidden-window subprocess request.
Configure harnesses explicitly:
terminal-commander setup harnessOr target one provider:
terminal-commander setup harness --provider cursor
terminal-commander setup harness --provider codex-cli
terminal-commander setup harness --provider claude-code
terminal-commander setup harness --provider claude-desktopUpdate
terminal-commander updateThis runs npm install -g terminal-commander@latest.
On Windows, update first runs a native scoped lock preflight. It terminates only
Terminal Commander binaries currently running from the installed npm platform
package bin directory. It does not invoke cmd.exe, PowerShell, taskkill, or
downloaded scripts.
Commands
| Binary | Role |
| --- | --- |
| terminal-commander | Admin CLI: version, update, setup, doctor, native diagnostics |
| terminal-commander-mcp | MCP stdio adapter launched by the LLM harness |
| terminal-commanderd | Local daemon for IPC, probes, policy, buckets, and audit |
LLM Trust Contract
system_discover is the source of truth for the live MCP tool catalogue. It is
callable even when the daemon is down and reports daemon_available plus
per-tool requires_daemon, available, and unavailable_reason fields. Tools
that require the daemon report daemon_unavailable instead of forcing clients
to infer reachability from raw pipe or socket errors.
The admin CLI also refuses fake offline success. Daemon-backed inspection
commands that are not wired to live daemon IPC exit 69 with an unavailable
message instead of returning empty or not-found success.
Platform Packages
Optional platform dependencies:
@terminal-commander/linux-x64@terminal-commander/linux-arm64@terminal-commander/windows-x64@terminal-commander/mac-x64@terminal-commander/mac-arm64
Windows uses the native @terminal-commander/windows-x64 package by default.
The legacy Windows-to-WSL bridge is opt-in with TC_USE_LEGACY_WSL_BRIDGE=1.
Documentation
Full README, architecture diagrams, and integration guides:
https://github.com/special-place-ai-heaven/terminal-commander/blob/main/README.md
License
PolyForm-Noncommercial-1.0.0
