# Twin Me Up

> Twin Me Up is an open-source MCP server for ai models and llm tooling. Local work twin that gives every AI agent your confirmed guidance and explicit grants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Repository:** https://github.com/gitdakky/twin-me-up
- **MCP Registry name:** io.github.GitDakky/twin-me-up
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

Agents here propose, and only you decide. A twin is a local SQLite store holding your guidance, grants and candidate lessons, and the passphrase set at init time is never given to agents. Confirming lessons, granting authority, exporting and erasing all refuse to run without it. Actions in the reserved twin namespace cannot be granted to anyone.

The workflow is a loop. At the start of work the agent calls twin_brief to get your guidance for that kind of task. Before anything consequential, such as sending, paying, publishing or deleting, it calls twin_authorise, which answers allow only when a live grant covers the action and otherwise returns ask. The agent then prepares a draft and requests approval. Corrections you make are recorded as candidate lessons.

Optional pre-action hooks for Hermes, Claude Code and pi block or escalate ungranted tool calls and fail closed. The README documents thirteen agent systems, ten verified live, and says data stays on your machine with no telemetry. The author states it is not a chatbot of you or an autonomous replacement.

## Features

- **Briefing at start of work:** twin_brief returns confirmed guidance, boundaries and escalation rules for a workflow.
- **Grant-based authorisation:** Actions are allowed only under explicit, scoped grants that can expire; otherwise the answer is ask.
- **Approval requests:** Agents draft an action and wait for your approval before acting.
- **Lessons you ratify:** Corrections become candidate lessons that only you can confirm, revise or retire.
- **Enforcement hooks:** Optional hooks outside the model block ungranted tool calls.
- **Local and exportable:** SQLite store with owner-only files, tamper-evident audit log, export and erasure.

## Good for

- Keep one set of working preferences across several agents
- Require approval before an agent sends, pays or publishes
- Capture corrections so an agent stops repeating a mistake
- Test whether a twin beats a generic assistant on held-out decisions

## Install

### Claude Code (Terminal)

```sh
claude mcp add twin-me-up -- uvx twin-me-up
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "twin-me-up": {
      "command": "uvx",
      "args": [
        "twin-me-up"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "twin-me-up": {
      "command": "uvx",
      "args": [
        "twin-me-up"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "twin-me-up": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "twin-me-up"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "twin-me-up": {
      "command": "uvx",
      "args": [
        "twin-me-up"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "twin-me-up": {
      "command": "uvx",
      "args": [
        "twin-me-up"
      ]
    }
  }
}
```

## Tools

- `twin_brief`: Returns your confirmed guidance and current authorisations for a workflow.
- `twin_authorise`: Checks whether a live grant covers an action; answers allow or ask.
- `twin_request_approval`: Asks you to approve a prepared action.
- `twin_approval_status`: Reports whether an approval request has been approved.
- `twin_record_correction`: Records a correction you made so it can become a candidate lesson.

## FAQ

### How do I install it?

Run uv tool install twin-me-up or pipx install twin-me-up, then twinmeup init in your own terminal.

### Can an agent confirm its own lessons?

No. Only you can confirm, reject or retire lessons, and the commands need your passphrase.

### Where is my data kept?

In a local SQLite store, by default in ~/.twinmeup. The README says there is no telemetry.

### Which platforms are tested?

macOS and Linux are tested; Windows should work but is untested.

### Is Twin Me Up free?

Yes. Twin Me Up is open source, so you can use and self-host it for free.

### How do I add Twin Me Up to Claude Code?

Run this command in your terminal: claude mcp add twin-me-up -- uvx twin-me-up

### What are the best alternatives to Twin Me Up?

The closest alternatives to Twin Me Up are Codebase Memory, XERJ, headroom, omniget and next-ai-draw-io.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [headroom](https://ai-powered.com/mcp/headroom-3): headroom is an open-source MCP server for ai models and llm tooling.
- [omniget](https://ai-powered.com/mcp/omniget): omniget is an open-source MCP server for ai models and llm tooling.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [unity-mcp](https://ai-powered.com/mcp/unity-mcp-2): unity-mcp is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/twin-me-up
