Open source · MIT · Zero dependencies

A nervous system
for AI agents

Vigil gives your agents persistent awareness, not just memory. Structured session handoff, frame-based tool filtering, a lightweight signal protocol, and an MCP server that works with Claude, Cursor, and anything else — all in a single Python package.

$ pip install vigil-agent
14
modules
268
tests
7,500+
lines
0
dependencies
MIT
license

The problem

Agents are blind between sessions

Every time an agent boots, it starts from zero. No context, no history, no coordination.

Cold starts every session

Agents forget everything between conversations. Re-reading codebases, re-establishing context, re-making decisions already made — every single time.

50K+ tokens wasted on tool definitions

MCP servers dump their entire tool list into every context window. In large servers, that's 40–80K tokens per session before the agent does anything useful.

Agents can't coordinate

Multi-agent systems have no shared awareness layer. One agent's work is invisible to another. Handoffs fail silently. No signal bus, no event protocol.

What you get

Everything agents need to stay aware

Six production-grade modules, zero dependencies, single install.

Awareness Daemon

<1s boot

Background process compiles system state into a structured AWARENESS.md every 90 seconds. Agents boot with full context — no cold starts.

vigil daemon start

Frame-Based Tool Filtering

75–85% savings

Expose only the tools relevant to the current task. Switch frames with a query param. Eliminate 40–80K tokens of noise from every context window.

/sse?frame=backend

Signal Protocol

event bus

Lightweight structured signals between agents and systems. Post from anywhere — CLI, Python, HTTP. Queryable signal history. Coordination without queues.

vigil signal "deploy complete"

Session Handoff

structured

Structured STATE.md written at session end. Next agent — or next session of the same agent — picks up exactly where you left off. No verbal summaries needed.

vigil handoff --write

Knowledge Auto-Extract

pattern detect

Vigil watches signals and session logs to extract durable knowledge — patterns, decisions, corrections. Stored and surfaced automatically, not buried.

vigil knowledge list

MCP Server

stdio + SSE

Built-in MCP server exposes all Vigil tools to any MCP-compatible client. Works out-of-the-box with Claude, Cursor, Windsurf, and any MCP host.

vigil serve --transport sse

How it works

Up in three commands

No configuration files required to get started. Works with your existing MCP setup.

1

Install

Single package from PyPI. No dependencies pulled in.

$ pip install vigil-agent
2

Initialize and start the daemon

Creates a vigil.db and begins compiling AWARENESS.md every 90 seconds.

$ vigil init
$ vigil daemon start
✓ Daemon running. Awareness compiling every 90s.
3

Start the MCP server

Point Claude or Cursor at the SSE URL. Add a frame param to scope tools.

$ vigil serve
# or with frames
$ vigil serve --transport sse --port 8100
✓ MCP server live at http://localhost:8100/sse

Pricing

Start free. Scale when ready.

The open-source core is always free. Hosted cloud tier is coming Q3 2026.

Hosted tier launching Q3 2026 — join the waitlist to get notified

Free

$0

forever · open source

  • 1 project
  • 2 agents
  • 5K signals / mo
  • All core modules
  • Self-hosted
Start Free

Team

$29 / mo

cloud hosted · coming Q3

  • 5 projects
  • Unlimited agents
  • 200K signals / mo
  • SSO / team access
  • Priority support
Join Waitlist

Enterprise

$99 / mo

cloud hosted · coming Q3

  • Unlimited projects
  • Unlimited agents
  • Unlimited signals
  • SLA + uptime guarantee
  • Custom frames
Contact Us

How it fits

The awareness layer, not a replacement

Vigil is complementary to memory tools. It handles coordination, awareness, and tool scope — the layers that memory libraries don't cover.

Capability Vigil Mem0 Letta LangGraph
Session awareness / context compile partial
Frame-based tool filtering
Signal / event protocol partial
Structured session handoff partial partial
Vector / semantic memory
Multi-agent orchestration signals
Native MCP server
Zero dependencies

Use Vigil alongside Mem0 or Letta — they operate at different layers. Vigil handles coordination and awareness; memory tools handle retrieval.

Give your agents a nervous system

Open source. Zero dependencies. Works with Claude, Cursor, and any MCP client.