- Vigil — Cognitive Infrastructure for AI Agents
Vigil — Cognitive Infrastructure for AI Agents
A nervous system for AI agents — awareness daemon, frame-based tool filtering, signal protocol, session handoff, and event triggers. 14 modules, 268 tests, zero dependencies. MCP server with stdio and SSE transports.
Overview
Vigil — Cognitive Infrastructure for AI Agents
A nervous system for AI agents. Not another memory store — Vigil coordinates awareness across agents and sessions.
The Problem
- Agents forget everything between sessions — every conversation starts cold
- Loading all tools into context wastes 50K+ tokens before useful work begins
- Multiple agents can't coordinate without being in the same process
Key Features
- Awareness Daemon — compiles system state every 90s into hot context. Agents boot with full awareness in <1 second
- Frame-Based Tool Filtering — tag tools with context modes. Backend mode sees 14 tools, not 95. Saves 75-85% of tokens
- Signal Protocol — lightweight event bus with content budgets (300-800 chars). Agents coordinate without direct communication
- Session Handoff — structured summaries (files, decisions, blockers, next steps). Handoff chains track continuity
- Knowledge Auto-Extract — daemon identifies recurring patterns in signals and suggests persistent knowledge entries
- Event Triggers — pattern-match on signals and fire webhooks, Slack alerts, focus items, or log entries
- MCP Server — 12 tools over stdio or SSE. Works with Claude Code, Cursor, Claude Desktop, Windsurf
Quick Start
pip install vigil-agent
vigil quickstart
vigil serve --transport stdio
Stats
- 14 modules, 7,500+ lines, 268 tests
- Zero dependencies beyond stdlib (MCP is optional)
- SQLite storage, zero infrastructure
- MIT license
Integrations
Claude Code, Cursor, Claude Desktop, GitHub Actions, Slack, Discord
Links
- PyPI:
pip install vigil-agent - GitHub: https://github.com/AlexlaGuardia/Vigil
Server Config
{
"mcpServers": {
"vigil": {
"command": "vigil",
"args": [
"serve",
"--transport",
"stdio"
]
}
}
}Project Info
Created At
3 months agoUpdated At
3 months agoAuthor Name
Alex LaGuardiaStar
-Language
-License
-Recommend Servers
View AllDocwand
14 hours ago
mcp-server-flomo MCP Server
@chatmcp
Write notes to Flomo
JavaScript
a year ago
Playwright Mcp
@microsoft
Playwright MCP server
TypeScript
10 months ago