Command Center
by 1xOps
README.md
<p align="center"><img src="mcp-server/logo.png" width="120" alt="1xOps Command Center"></p>
# 1xOps Command Center
**Your AI agent keeps a terminal open β tests, logs, REPLs and SSH β inside the folders you allow.**
A local MCP server: shell sessions that stay open between turns, plus text-file tools, under one folder limit and one command blocklist that only a person can change. It runs on your machine with your permissions and sends nothing anywhere.
```
/plugin marketplace add 1xOps/command-center
/plugin install command-center@command-center
```
## πΌ What teams use it for
| Scenario | How it works | Why it helps |
|---|---|---|
| π§ͺ **Fix a failing test suite** | Run the tests, read the failures, edit, run again β in the same shell | The environment stays set up; the engineer reviews one diff |
| π¨ **Watch logs during an incident** | Start a tail, read new output on demand, stop it with `force_terminate` | A second pair of eyes on live output; nothing left running afterwards |
| π **Check data in a REPL** | `python3 -i` or `node -i` keeps the data loaded across turns | Answers come from the data, not from a script re-run each time |
| π **Diagnose a server over SSH** | One `ssh` session kept open across turns | Faster remote triage. The blocklist checks the remote command and each typed line; the remote account's permissions are still the real limit |
| π’ **One approved setup for the team** | Commit a pinned `.mcp.json` | Every seat runs the same reviewed version |
## π§© Clients and platforms
| Client | Install | macOS | Linux | Windows |
|---|---|:-:|:-:|:-:|
| Claude Code β plugin (server + 6 skills) | `/plugin install` above | β | β | β ΒΉ |
| Claude Code β server only | `claude mcp add` | β | β | β ΒΉ |
| Claude Desktop | `.mcpb` from [Releases](https://github.com/1xOps/command-center/releases) | β | | β ΒΉ |
| OpenAI Codex CLI | `codex mcp add` | β | β | β ΒΉ |
| VS Code (agent mode) | `.vscode/mcp.json` | β | β | β ΒΉ |
Node.js 24 or later (Claude Desktop installs it from the `.mcpb`). 20 tools β see [`mcp-server/README.md`](mcp-server/README.md#-tools-20).
ΒΉ Windows code paths and tests exist; a Windows CI run has not happened yet.
<details>
<summary><b>βοΈ Install for each client (pinned to 0.4.2)</b></summary>
Replace `/path/to/project` with the folders the agent may use; they become `allowedDirectories` for that session.
> **The plugin passes no folder.** With no folder and an empty `allowedDirectories` there is **no folder limit**. Set `allowedDirectories` in `~/.command-center/config.json`, or use a server-only install with a folder.
```bash
# Claude Code, server only
claude mcp add command-center -- npx -y @1xops/command-center@0.4.2 /path/to/project
# OpenAI Codex CLI
codex mcp add command-center -- npx -y @1xops/command-center@0.4.2 /path/to/project
```
**VS Code** β `.vscode/mcp.json`:
```json
{ "servers": { "command-center": { "type": "stdio", "command": "npx", "args": ["-y", "@1xops/command-center@0.4.2", "${workspaceFolder}"] } } }
```
**Claude Desktop** β open `command-center-0.4.2.mcpb` from [Releases](https://github.com/1xOps/command-center/releases); it asks which folders Command Center may use.
</details>
<details>
<summary><b>π’ Team configuration (one pinned setup for every seat)</b></summary>
Claude Code β commit `.mcp.json` at the project root:
```json
{ "mcpServers": { "command-center": { "command": "npx", "args": ["-y", "@1xops/command-center@0.4.2", "."] } } }
```
Codex β `~/.codex/config.toml`:
```toml
[mcp_servers.command-center]
command = "npx"
args = ["-y", "@1xops/command-center@0.4.2", "/path/to/project"]
```
Check where a build came from: `npm view @1xops/command-center@0.4.2 dist.attestations` (npm provenance from the CI release).
</details>
<details>
<summary><b>π¦ Container (a real boundary for the host)</b></summary>
Non-root user; sees only the mounted folder. Build from a checkout of this repo:
```bash
docker build -t command-center:0.4.2 mcp-server
claude mcp add command-center -- docker run -i --rm --network none -v "/path/to/project:/workspace" command-center:0.4.2
```
`--network none` cuts network access for untrusted work; drop it if sessions need the network.
</details>
<details>
<summary><b>π‘οΈ Security model</b></summary>
Command Center runs commands with **your** permissions and trusts the AI client driving it. It does not detect prompt injection.
| Control | What it does | Security boundary? |
|---|---|---|
| `allowedDirectories` | Every file tool and session working folder must be inside these folders (symlinks resolved first). Empty = no limit | No |
| `blockedCommands` | Refuses listed programs wherever they start a command, incl. after `;` `&&` `\|` `$(β¦)`, `sh -c`, `env`/`timeout` wrappers; always refuses `eval` / `Invoke-Expression`. Defaults include `sudo`, `dd`, `mount`, `diskpart`, `reg` | No |
| Person-only settings | `set_config_value` refuses `allowedDirectories`, `blockedCommands`, `defaultShell`; file tools refuse the config folder | No |
| Container | Non-root, only the mounted folder visible | **Yes**, for the host filesystem |
**Limits:** a program started in a session can reach any path and network you can, and could edit the config file (it applies at the next start). The command check reads command lines (including lines typed into a shell or `ssh` session), not scripts or REPL input. Each session keeps its last 1 MiB of output in memory.
**Privacy:** no telemetry, analytics, update checks or remote calls. See [SECURITY.md](mcp-server/SECURITY.md) Β· [PRIVACY.md](mcp-server/PRIVACY.md).
</details>
## π In this repository
| Folder | What it is |
|---|---|
| [`mcp-server/`](mcp-server/README.md) | npm package `@1xops/command-center`: server, tests, Claude Desktop bundle, container |
| [`plugins/command-center/`](plugins/command-center/README.md) | Claude Code plugin: the pinned server plus six skills |
| [`docs/supply-chain/register.md`](docs/supply-chain/register.md) | Every shipped package and its licence, signed by the owner |
MCP Registry `io.github.1xOps/command-center` Β· Apache-2.0 Β© 2026 1xOps Β· Report vulnerabilities privately: [SECURITY.md](mcp-server/SECURITY.md)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues