Skip to content
Vindicate

Vindicate Platform

Autonomous quality for AI-native development teams.

AI-native Playwright test automation for VS Code, Cursor, GitHub Copilot, Claude Code, and Antigravity.

GitHub top language visitors GitHub forks GitHub contributors GitHub Repo stars GitHub repo size GitHub watchers GitHub issues GitHub pull requests GitHub

Architecture

Vindicate is a stateless local stack. The extension installs rules and skills, then your agent (Cursor, GitHub Copilot, Claude Code, or Antigravity) calls a local MCP server for workflow guidance, codegen, and browser tools. No cloud job machine, no MongoDB, no remote orchestration.

flowchart TB
    subgraph ide["Your editor"]
        Agent["AI agent"]
        Ext["Vindicate extension"]
    end

    subgraph local["This machine, 127.0.0.1 only"]
        MCP["runtime-mcp"]
        Worker["runtime-worker"]
        Chromium["Chromium"]
    end

    Agent -->|MCP tools| MCP
    Ext -->|spawns + supervises| MCP
    Ext -->|spawns + supervises| Worker
    MCP -->|browser / record / API| Worker
    Worker --> Chromium
Loading
Component Role
VS Code / Cursor extension Onboarding, dashboard, agent pairing, process supervisor
runtime-mcp MCP server the agent talks to: workflow, codegen, tools
runtime-worker Playwright browser sessions, recordings, and API requests

runtime-mcp and runtime-worker are machine-wide singletons. Isolation between projects is per session, not per process. Full detail: docs/ARCHITECTURE.md.

Workspace layout

apps/
  runtime-mcp/       Local MCP server (workflow + codegen + tools)
  runtime-worker/    Playwright browser + recording worker
  vscode-extension/  VS Code / Cursor extension
  vindicate-ui/      Bundled MCP Apps panel UI
packages/
  protocol/          Shared Zod contracts
  config/            Shared configuration presets
  security/          Security policy and auth types
  observability/     Structured logging (Pino)

Tooling

  • Node.js >=22
  • pnpm >=10
  • Turborepo

Common commands

From repository root:

pnpm lint
pnpm typecheck
pnpm test
pnpm build

Build the runnable apps:

pnpm turbo build --filter=@vindicate/runtime-mcp
pnpm turbo build --filter=@vindicate/runtime-worker
pnpm turbo build --filter=vindicate

Docs

Changelog

See CHANGELOG.md.

License

Licensed under the Apache License, Version 2.0.

Contributors

Contributors to OpenEvident/vindicate

About

A local-first Playwright test automation toolkit for AI coding agents (Cursor, Claude Code, Copilot), with MCP tools for codegen, browser control, and recordings.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

45 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages