# limps

limps gives AI agents a shared local layer for Markdown files, plans, and task states. Use it when several MCP clients need the same project context.

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

## What it does

limps connects an agent to any folder containing Markdown files. It exposes document creation, reading, updates, deletion, full-text search, plan tracking, and task status changes. The index uses SQLite while the source files stay in the folder you choose.

The server can be used from Claude Code, Codex, Cursor, and other MCP clients. Separate `.limps/config.json` files can target different projects, while several clients can work with the same documents. Initialize a folder with `limps init`; the commands `limps server start`, `limps server stop`, and `limps server status` control the background HTTP daemon.

A folder or configuration change requires a server restart unless the file watcher has refreshed the index. Document processing through `process_doc` and `process_docs` runs JavaScript inside a QuickJS sandbox with no network or Node APIs.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add limps -- npx -y @sudosandwich/limps
```

### Codex

**Platform CLI**
```bash
codex mcp add limps -- npx -y @sudosandwich/limps
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "limps": {
            "command": "npx",
            "args": [
                "-y",
                "@sudosandwich/limps"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "limps": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@sudosandwich/limps"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add limps npx -y @sudosandwich/limps
```

## When to use it
- keep plans in a shared folder
- search Markdown files by full text
- track task states across agents
- share project context between MCP clients

## Example prompts
- Create a migration plan and add tasks for the database changes.
- Search the Markdown documents for decisions about authentication.
- Show the current plan status and suggest the next task.

## Similar
- [prd](https://affpapa.org/en/nevibecode/skills/snarktank-prd.md) — skill · 1500 installs
- [gepetto](https://affpapa.org/en/nevibecode/skills/gepetto.md) — skill · 1500 installs
- [creating-development-plans](https://affpapa.org/en/nevibecode/skills/creating-development-plans.md) — skill · 330 installs
- [idea-refine](https://affpapa.org/en/nevibecode/skills/idea-refine.md) — skill · 59200 installs
- [update-implementation-plan](https://affpapa.org/en/nevibecode/skills/update-implementation-plan.md) — skill · 11107 installs
- [breakdown-feature-prd](https://affpapa.org/en/nevibecode/skills/breakdown-feature-prd.md) — skill · 10022 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