# Limoni

Limoni enables AI agents to inspect and drive Go terminal applications using widget semantic trees rather than raw screen characters.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 196 repo stars
- Author: thebanri
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thebanri/limoni/tree/HEAD/cmd/limoni-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — warning: a command downloads a script from raw.githubusercontent.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/limoni

## What it does

Limoni exposes a dedicated MCP interface so models can navigate terminal programs built in Go. Traditional console automation breaks whenever layouts shift by a single character. This server bypasses raw character grids by exposing structured widget hierarchies directly to the model.

Under the hood, the server exposes eight automation actions, including `tree`, `click`, `type_text`, and `wait_for`. The control channel runs over an internal domain socket that only appears when building the Go binary with the `limoni_debug` tag. Connections are restricted to the local user account, keeping sensitive input masked from automated reading.

Launching the binary without the debug build tag prevents the automation socket from ever opening.

## Requirements
- Needs: a prebuilt binary from the repository releases

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- run automated end-to-end checks on terminal interfaces
- submit console forms and confirm dialogs through an agent
- target interactive widgets by label instead of terminal coordinates
- verify screen updates without hardcoded sleep timers

## Example prompts
- "Inspect the current widget tree and click the submit button"
- "Wait for the status indicator to update and report the message"
- "Type the deployment name into the active task field"

## Similar
- [tui-validate](https://affpapa.org/en/nevibecode/skills/tui-validate.md) — skill · ★ 3206 repo stars
- [tui-verify-change](https://affpapa.org/en/nevibecode/skills/tui-verify-change.md) — skill · ★ 720 repo stars
- [codex-tui-proof](https://affpapa.org/en/nevibecode/plugins/codex-tui-proof.md) — plugin · ★ 1596 repo stars
- [control-cli](https://affpapa.org/en/nevibecode/skills/control-cli.md) — skill · 2700 installs
- [terminal-control](https://affpapa.org/en/nevibecode/skills/terminal-control.md) — skill · 628 installs
- [opentui](https://affpapa.org/en/nevibecode/skills/opentui.md) — skill · 64600 installs

---
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
