# Ompconf

> Standalone OMP config, skill, plugin, and MCP browser

- **Type:** MCP server
- **Install:** `agentstack add mcp-wolfiesch-ompconf`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [wolfiesch](https://agentstack.voostack.com/s/wolfiesch)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [wolfiesch](https://github.com/wolfiesch)
- **Source:** https://github.com/wolfiesch/ompconf

## Install

```sh
agentstack add mcp-wolfiesch-ompconf
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ompconf

**Browse, audit, and repair Oh My Pi config from one terminal UI.**

[](LICENSE)
[](https://bun.sh)
[](#quick-start)

`ompconf` is a standalone config manager for Oh My Pi users. It gives you a browser for MCP servers, skills, plugins, snapshots, and diagnostics without opening config files by hand.

  

  

## Why use it?

| Need | What `ompconf` gives you |
| --- | --- |
| Understand an OMP setup | One overview of MCP servers, skills, plugins, snapshots, and diagnostics. |
| Inspect config safely | Read-only status, list, doctor, and TUI views with redaction by default. |
| Fix MCP state | Enable or disable MCP server entries through commands or the TUI. |
| Audit extension sprawl | Browse global, project, managed, and external skills with status markers. |
| Recover from config changes | Snapshot and rollback support before mutating operations. |

## Screenshots

All screenshots below use the sanitized demo fixture in `demo/fixtures`. They do not show a real user profile, private MCP URLs, local home paths, tokens, or personal infrastructure.

### Overview

  

The Overview screen shows the complete config surface at a glance: diagnostics, MCPs, skills, plugins, and rollback snapshots.

### MCP browser

  

The MCP view shows server status, scope, transport summary, config path, and enable/disable actions. Mouse click, double-click, `e`, and `d` are wired to the same action path.

### Skills browser

  

The skills view separates user and project skills, shows validity, and previews descriptions so duplicate or stale instruction packs are easier to spot.

### Plugin surfaces

  

The plugins view combines package, lockfile, registry, and installed-plugin surfaces into one browseable list.

### Inline search

  

Press `/` to search the current section without leaving the TUI. Normal navigation keys are blocked while the search box is focused, so text input does not accidentally move rows or toggle servers.

## Quick start

```bash
git clone https://github.com/wolfiesch/ompconf.git
cd ompconf
bun install
bun link
ompconf tui
```

Run read-only checks first:

```bash
ompconf status
ompconf doctor
ompconf list --kind skill
ompconf list --kind mcp
```

Use JSON when you want stable machine-readable output:

```bash
ompconf status --json
ompconf list --kind mcp --json
ompconf tui --render --screen mcp --query chrome
```

## TUI controls

| Control | Action |
| --- | --- |
| `/` | Search within the active section. |
| `j` / `k` or arrow keys | Move through rows. |
| `[` / `]` or Tab | Switch sections. |
| Mouse click | Select a row. |
| Mouse wheel | Scroll list or details panes. |
| Double-click, `e`, `d` | Toggle a selected MCP server when the row is actionable. |
| `q`, Esc, Ctrl-C | Quit. |

## Commands

| Command | Purpose |
| --- | --- |
| `ompconf status` | Show counts, active paths, and warnings. |
| `ompconf doctor` | Report diagnostics for MCPs, skills, plugins, and config files. |
| `ompconf list --kind ` | List MCPs, skills, plugins, marketplaces, or all supported list surfaces. |
| `ompconf mcp ` | Manage MCP config entries. |
| `ompconf skill ...` | Inspect and manage skills. |
| `ompconf snapshot` | Create rollback checkpoints. |
| `ompconf rollback` | Restore a prior snapshot. |
| `ompconf tui` | Open the interactive terminal browser. |

Global scoping flags keep demos, tests, and audits isolated:

```bash
ompconf status \
  --home demo/fixtures/home \
  --cwd demo/fixtures/home/workspace/example-project \
  --state-dir demo/fixtures/home/.ompconf
```

## Screenshot fixture

Regenerate the sanitized fixture:

```bash
bun scripts/generate-demo-fixture.js
```

Render a screenshot with VHS:

```bash
vhs demo/tapes/overview.tape
```

The fixture intentionally uses only `example.com` and local `~`-redacted paths. Do not use a live OMP home for marketing screenshots.

## Development

```bash
bun install
bun test
bun run check
```

Focused TUI checks:

```bash
bun test test/tui.test.ts test/tui-theme.test.ts
ompconf tui --render --screen mcp --query chrome
```

## Release safety

Before publishing screenshots or docs, scan the candidate assets for:

- absolute home paths such as `/Users/...` or `/home/...`
- real MCP URLs, internal hostnames, or infrastructure names
- tokens, API keys, cookies, credentials, or authorization headers
- live diagnostics from a personal profile

Use `demo/fixtures` for public material. Use your real `~/.omp` only for private debugging.

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [wolfiesch](https://github.com/wolfiesch)
- **Source:** [wolfiesch/ompconf](https://github.com/wolfiesch/ompconf)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-wolfiesch-ompconf
- Seller: https://agentstack.voostack.com/s/wolfiesch
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.