Vigil - AI Security Audit and Cryptographic Proof
LocalAbout Vigil - AI Security Audit and Cryptographic Proof
Vigil is a dashboard for teams managing AI agents, with controls for assignments, budgets, live activity, alerts, and compliance reporting. It connects OpenAI, Anthropic, and custom agents.
Key features
- 01Connect OpenAI, Anthropic, and custom agents
- 02Assign tasks, goals, and budgets
- 03Monitor agent activity and costs
- 04Send alerts for policy issues
- 05Export compliance audit trails
Use cases
- 01Set spending limits for agent tasks
- 02Track agent activity across teams
- 03Alert on unauthorized tools or PII
- 04Prepare SOC 2 or ISO 42001 reports
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEControl your AI agents. Track costs. Stay compliant. open-souce
What It Does
One dashboard to manage your AI team.
| Feature | How It Helps |
|---|---|
| Connect your agents | Plug in OpenAI, Anthropic, or custom agents |
| Set goals & budgets | Assign work, cap costs, define success |
| Watch in real-time | See what every agent is doing right now |
| Get alerts | Slack, email, or PagerDuty when something's off |
| Prove compliance | Export audit trails for SOC 2, ISO 42001 |
Quick Start (5 Minutes)
1. Start the database
docker compose up -d postgres
2. Install & configure
npm install
cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env
Or run one command:
npm run setup:local
3. Run it
# Terminal 1: API
npm run dev:api
# Terminal 2: Dashboard
npm run dev:web
Or run both in one terminal:
npm run dev:all
4. Open http://localhost:5173
Verify Everything Is Connected
npm run check:stack
If API + web are running, seed demo data:
npm run seed:demo
Troubleshooting (macOS)
1) cp .env.example ... fails
Use the correct paths from repo root:
cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env
2) Cannot connect to the Docker daemon
- Start Docker Desktop
- Wait until Docker says it is running
- Retry:
docker compose up -d postgres
3) API error ECONNREFUSED ... :5432
PostgreSQL is not reachable. Confirm:
docker compose ps
Then restart API:
npm run dev:api
Example: Customer Support Team
Create a team
POST /api/teams
{
"name": "Support Squad",
"agents": [
{ "provider": "openai", "model": "gpt-4", "role": "triage" },
{ "provider": "anthropic", "model": "claude-3", "role": "escalation" }
],
"goals": [
{ "metric": "response_time", "target": "< 2 min" }
]
}
Assign work
POST /api/tasks
{
"team_id": "<your-team-id>",
"description": "Handle refund requests",
"budget": { "usd": 5.00, "tokens": 10000 },
"policies": ["no_pii_exposure", "enforce_budget_limits"]
}
Get alerts when agents go off-script
- Budget exceeded -> Slack notification
- Unauthorized tool -> Email alert + auto-stop
- PII detected -> PagerDuty escalation
Export compliance reports
GET /api/compliance/report?type=SOC_2_Type_II
Dashboard
| Screen | What You See |
|---|---|
| Overview | All teams, active agents, cost burn today |
| Agents | Add/edit teams, connect providers |
| Tasks | Queue, assign work, monitor progress |
| Costs | Budgets, spend trends, forecasts |
| Governance | Policy violations, audit logs |
| Alerts | Real-time feed, escalation history |
Built With
- Backend: Node.js + Express + PostgreSQL
- Frontend: React + Vite
- Integrations: OpenAI, Anthropic, Slack, PagerDuty, email
Ready to control your AI team?
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.