# IWE (iwe.md)

Keeps agent memory in linked Markdown notes inside a project. Use it to retain decisions, plans, and context across sessions.

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

## What it does

IWE connects an agent to a folder of Markdown documents containing plans, specifications, decisions, and other project notes. The agent can read that context, save new findings, and reorganize documents while you keep direct control of the files.

The MCP server runs through `@iwe-org/mcp`. It does not include an AI model; it provides tools for working with notes while the model comes from your connected agent. The server works with the notes directory used at launch, so a Markdown note folder is required for it to have project context to read or change. IWE can be connected to Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add iwe -- npx -y @iwe-org/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add iwe-iwemd -- npx -y @iwe-org/mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add iwe-iwemd npx -y @iwe-org/mcp
```

## When to use it
- retain agent decisions between sessions
- search earlier project context in Markdown notes
- link plans, specifications, and decisions
- organize project memory in a folder

## Example prompts
- Save the decision from this task in the project's Markdown notes.
- Find notes about earlier decisions for this feature and use them while working.
- Organize the project notes by linking plans to specifications and removing duplicates.

## Similar
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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