Vigil — Cognitive Infrastructure for AI Agents

Created By
Alex LaGuardia3 months ago
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

  1. Agents forget everything between sessions — every conversation starts cold
  2. Loading all tools into context wastes 50K+ tokens before useful work begins
  3. 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

Server Config

{
  "mcpServers": {
    "vigil": {
      "command": "vigil",
      "args": [
        "serve",
        "--transport",
        "stdio"
      ]
    }
  }
}
Project Info
Created At
3 months ago
Updated At
3 months ago
Author Name
Alex LaGuardia
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Mnemom

14 hours ago
//beforeyouship — LLM Cost Modeling From Your Editor
@Indiegoing

Query realistic LLM cost models without leaving your editor. beforeyouship models the **true monthly cost** of an LLM app architecture — retries, prompt caching, batch discounts, infra overhead, and 3×/10× growth — across GPT-5.x, Claude, Gemini, DeepSeek, and more. Not a token calculator: a planning tool for the design phase, before you commit to a stack. **No API key needed to try it** — demo mode covers the six free-tier models. A Pro key from [beforeyouship.dev](https://beforeyouship.dev) unlocks the full 18-model catalog. ## What you can ask - "How much will a RAG chatbot cost at 10,000 requests/day?" - "Compare Claude Haiku vs Gemini Flash pricing for my workload" - "What's the cheapest model for a multi-step agent at scale?" - "Show me current per-token prices for Anthropic models" ## Tools ### `estimate_cost` Full cost model for an architecture at a given usage level. Returns Naive / Realistic / Worst Case monthly cost per model, 3×/10× growth scenarios, and an opinionated recommendation with reasoning. ### `get_model_prices` Current per-1M-token pricing — input, output, cached input, batch — with context windows and staleness metadata. ### `list_archetypes` Seven preset architecture patterns (simple chatbot, chatbot with history, RAG pipeline, multi-model router, coding assistant, document processor, multi-step agent) used as starting points for estimates. ## Setup **Claude Code:** ​```bash claude mcp add --transport http beforeyouship https://beforeyouship.dev/api/mcp ​``` **Cursor / other clients** — add a remote server: ​```json { "mcpServers": { "beforeyouship": { "type": "streamable-http", "url": "https://beforeyouship.dev/api/mcp" } } } ​``` Add an `Authorization: Bearer bys_...` header with a Pro key for the full catalog. ## Try it > Estimate the monthly cost of a RAG pipeline at 10,000 requests/day

13 hours ago
Docwand

13 hours ago