# Yapitalism

Controls terminal coding agents through voice and verifies execution using verifiable terminal receipts. Built for working away from your display.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: AytuncYildizli
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AytuncYildizli/yapitalism
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/yapitalism

## What it does

This local MCP server bridges voice clients to CLI coding tools such as `claude`, `codex`, `kimi`, or `opencode`. Connections run over loopback at `127.0.0.1:48900` or attach directly to `tmux` panes. Before dispatching keystrokes, it checks the active process tree. If an agent exits into an open shell, the server halts submission immediately to stop accidental command execution.

Verification relies on explicit markers rather than basic HTTP status codes. A `GREEN` verdict requires the target agent to echo a distinct token back to the terminal. If characters land in an input buffer without proof of handling, the server returns `YELLOW`. Terminal spinner updates or log streams do not count as proof. Through `pane_await`, it identifies whether a turn concluded, timed out, or halted on an authentication dialog.

HTTP write access stays blocked out of the box. Unlocking it requires running `yapitalism authority allow-http-writes` on the host machine. Without `tmux` or a running Superset service, window automation will fail.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add yapitalism -- uvx yapitalism
```
uvx runs the command named after the package; if the README names another one, use uvx --from yapitalism <command>

### Codex

**Platform CLI**
```bash
codex mcp add yapitalism -- uvx yapitalism
```
uvx runs the command named after the package; if the README names another one, use uvx --from yapitalism <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yapitalism": {
            "command": "uvx",
            "args": [
                "yapitalism"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from yapitalism <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yapitalism": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "yapitalism"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from yapitalism <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add yapitalism uvx yapitalism
```
uvx runs the command named after the package; if the README names another one, use uvx --from yapitalism <command>

## When to use it
- track terminal agent status without looking at the monitor
- catch processes stuck on login prompts or permission gates
- prevent typing commands into raw shells after an agent crashes
- distinguish completed agent turns from unsubmitted input prompts

## Example prompts
- Check the current tmux agent state using `pane_await`
- Dispatch the test suite command via `pane_task` and check for a GREEN verdict
- List existing terminal sessions with `panes_list`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md