remembril-mcp 0.1.0

MCP server for Remembril - Change tracking and impact analysis

Remembril MCP Server

MCP (Model Context Protocol) server for Remembril — 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

pip install remembril-mcp

Quick Start

1. Setup for Claude Code

Run the setup script (if you have the repo):

cd mcp-server
./setup-claude-code.sh

Or configure manually in ~/.claude/settings.json:

{
  "mcpServers": {
    "remembril": {
      "command": "remembril-mcp",
      "args": ["serve"],
      "env": {
        "REMEMBRIL_URL": "http://localhost:7070",
        "REMEMBRIL_TOKEN": "your-token-here"
      }
    }
  }
}

2. Authenticate

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:

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

# 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