# Vigilis

Vigilis checks Playwright, Cypress, and Selenium tests, repairing harmless selector changes while refusing to mask a real regression. Its decisions leave receipts that can be checked offline.

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

## What it does

Vigilis works with an existing test suite and investigates failures. When a selector has changed, it can update the locator and rerun the test. When the application’s behaviour has genuinely regressed, it leaves the assertion intact and fails the gate. That refusal matters: the server does not make a broken test pass by weakening the check.

Use the MCP server to ask an agent to generate tests, investigate failures, or repair test drift from Claude Code and other supported clients. Vigilis also records an ordered receipt of its actions for offline verification; Treeship can add an independent signature. AI-powered tasks require `ANTHROPIC_API_KEY`, and the MCP client launches `npx -y vigilis-mcp`. Receipts for test runs can be created and verified without an API key.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ANTHROPIC_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add vigilis-mcp -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y vigilis-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add vigilis --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y vigilis-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vigilis": {
            "command": "npx",
            "args": [
                "-y",
                "vigilis-mcp"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vigilis": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "vigilis-mcp"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> vigilis npx -y vigilis-mcp
```
Replace <…> with your own values

## When to use it
- repair a locator after a selector changes
- stop the test gate on a real regression
- create a verifiable record of a test run
- ask an agent to generate and run a test scenario

## Example prompts
- Investigate the failed login test and update the locator only if the selector changed.
- Find out why the checkout test failed; leave its assertion alone if the app has regressed.
- Generate and run a test scenario for my application.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

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