remembril-mcp 0.1.0
MCP server for Remembril - Change tracking and impact analysis
Requires Python: >=3.10
Keywords: ai, change-tracking, impact-analysis, mcp, remembril

# Remembril MCP Server

MCP (Model Context Protocol) server for [Remembril](https://remembril.dev) — change impact tracking, autonomous coding loops, and documentation automation for AI coding assistants.

## What is Remembril?

Remembril tracks changes through your entire documentation hierarchy: Requirements, PRFAQ, HLD, LLD, Tests, Compliance, and Runbooks. When something changes, ripple effects propagate automatically. The autonomous coding loop can then implement those changes via Claude Code with an AI review committee as quality gate.

## Installation

```bash
pip install remembril-mcp
```

## Quick Start

### 1. Setup for Claude Code

Run the setup script (if you have the repo):
```bash
cd mcp-server
./setup-claude-code.sh
```

Or configure manually in `~/.claude/settings.json`:
```json
{
  "mcpServers": {
    "remembril": {
      "command": "remembril-mcp",
      "args": ["serve"],
      "env": {
        "REMEMBRIL_URL": "http://localhost:7070",
        "REMEMBRIL_TOKEN": "your-token-here"
      }
    }
  }
}
```

### 2. Authenticate

```bash
remembril-mcp login --url http://localhost:7070
```

### 3. Create a project and configure it

From Claude Code, just say:

> "Create a Remembril project for this repo and set up the coding loop"

The AI will call `remembril_project_create` and `remembril_project_configure` with your repo path, test command, etc.

Or via CLI:
```bash
remembril-mcp projects                    # List projects
remembril-mcp set-project YOUR_PROJECT_ID # Set default
```

## Available MCP Tools

### Project Management

| Tool | Description |
|------|-------------|
| `remembril_projects` | List all projects |
| `remembril_project_create` | Create a new project |
| `remembril_project_configure` | Configure repo path, test command, agent review, coding loop |
| `remembril_project_settings` | View current pipeline settings |

### Issues & Ripples

| Tool | Description |
|------|-------------|
| `remembril_issue_create` | Create a new issue |
| `remembril_issue_create_smart` | Create issue with auto-severity |
| `remembril_issue_list` | List issues with filters |
| `remembril_ripples_generate` | Generate ripple effects for an issue |
| `remembril_ripples_queue` | Get pending ripples for review |
| `remembril_ripple_approve` | Approve a ripple |
| `remembril_ripple_reject` | Reject a ripple with reason |
| `remembril_ripple_update` | Modify a ripple's changes |
| `remembril_ripple_apply` | Apply an approved ripple to its document |
| `remembril_ripple_diff` | View the diff a ripple would produce |
| `remembril_ripple_blind_review` | Get ripples with AI reasoning hidden (blind validation) |

### Pipeline & Documents

| Tool | Description |
|------|-------------|
| `remembril_pipeline_run` | Run the full auto-pipeline (issues -> ripples -> docs) |
| `remembril_pipeline_status` | Check pending work for a project |
| `remembril_pipeline_generate_docs` | Export documents to markdown |
| `remembril_docs` | List project documents |
| `remembril_doc_read` | Read a specific document |
| `remembril_doc_traceability` | View cross-document traceability matrix |

### Autonomous Coding Loop

| Tool | Description |
|------|-------------|
| `remembril_loop_start` | Start a coding loop (Issue -> Code -> Test -> Review -> Merge) |
| `remembril_loop_status` | Check loop progress, waves, and droplets |
| `remembril_loop_stop` | Stop a running loop |

### Agent Review (Auror Committee)

| Tool | Description |
|------|-------------|
| `remembril_review_run` | Run an AI review committee on content |
| `remembril_review_status` | Check review status |
| `remembril_review_list` | List reviews for a project |
| `remembril_review_approve_ripples` | Approve ripples from a review |
| `remembril_debate_create` | Start a debate between agents |
| `remembril_debate_status` | Check debate progress |
| `remembril_watcher_alerts` | View anomaly alerts from the watcher |
| `remembril_alert_handle` | Handle a watcher alert |
| `remembril_personas_list` | List available review personas |

### Code Intelligence

| Tool | Description |
|------|-------------|
| `remembril_scan` | Index a codebase for symbol tracking |
| `remembril_impact` | Analyze file change impact |
| `remembril_trace` | Trace requirement to code |
| `remembril_symbols` | Search code symbols |

### Orchestration

| Tool | Description |
|------|-------------|
| `remembril_orchestrate_status` | Check pending work |
| `remembril_orchestrate_start` | Start an orchestration session |
| `remembril_orchestrate_next` | Get next task in session |
| `remembril_orchestrate_complete` | Complete a task |
| `remembril_orchestrate_sessions` | List sessions |
| `remembril_orchestrate_generate_all` | Generate all pending ripples |

## CLI Commands

```bash
# Authentication
remembril-mcp login              # Login via browser
remembril-mcp login -t TOKEN     # Login with token
remembril-mcp logout             # Remove credentials
remembril-mcp status             # Check connection

# Projects
remembril-mcp projects           # List projects
remembril-mcp set-project ID     # Set default project

# Server
remembril-mcp serve              # Start MCP server (stdio)

# Issues
remembril-mcp issue "Title" -d "Description"
remembril-mcp issue "Title" --auto-severity

# Ripple Workflow
remembril-mcp run 123            # Generate ripples for issue
remembril-mcp review 123         # Interactive review
remembril-mcp review 123 --blind # Blind validation
remembril-mcp resume 123         # Resume reviewing
remembril-mcp logs               # View history
```

## Typical Workflow

```
1. Create project           -> remembril_project_create
2. Configure repo + tests   -> remembril_project_configure
3. Create issues             -> remembril_issue_create
4. Run pipeline              -> remembril_pipeline_run
   (generates ripples across Requirements, PRFAQ, HLD, LLD, Tests, Compliance, Runbook)
5. Start coding loop         -> remembril_loop_start
   (Claude Code implements changes, tests run, Auror committee reviews, auto-merge)
6. Check progress            -> remembril_loop_status
```

## Environment Variables

| Variable | Description |
|----------|-------------|
| `REMEMBRIL_URL` | API URL (default: https://remembril-production.up.railway.app) |
| `REMEMBRIL_TOKEN` | Authentication token |
| `REMEMBRIL_PROJECT_ID` | Default project ID |

## Configuration

Credentials stored in `~/.remembril/config.json` (600 permissions).

## License

MIT