System Agents

You're deep in a conversation with Meggy, asking about dinner plans and weekend weather. Behind the scenes, something quietly analyzes that conversation, extracts the fact that you prefer Italian food on Fridays, files it in memory, and moves on — all without you noticing. That's not magic. That's a system agent doing its job.

Meggy ships with five built-in system agents that handle the boring-but-essential maintenance tasks. They run on a schedule, stay out of your way, and make sure everything keeps working smoothly.

The Five System Agents

Think of them as a small maintenance crew, each with a clear specialty:

Agent What It Does When It Runs
Memory Agent Analyzes conversations, extracts facts and relationships, purges expired memories, and generates summaries Every 30 minutes
Maintenance Agent Cleans up orphaned data and stale people records Daily at 4 AM
Quality Agent Monitors your skills for quality drops and regression patterns Daily at midnight
Vault Agent Re-crawls URL-sourced documents for content changes and processes auto-tagging queues Daily at 3 AM
Integration Agent Checks OAuth token health, MCP server connectivity, and credential rotation needs Every 5 minutes

How It Works

System agents follow Meggy's standard parent + instances pattern. There's one System Agent definition that acts as the hub, and the five subsystems orbit it as individual instances — each with its own schedule, instructions, and on/off switch.

Always Running, Always Fresh

The system agent seeder runs on every app startup. It checks whether anything has changed since the last launch:

You're in Control

Even though system agents run automatically, you can customize them from the Agent Monitor view:

The Orbital Dashboard

Open the Agents view and switch to Orbital mode. You'll see the System Agent as a larger central node with five smaller satellites orbiting it — one for each subsystem. Each satellite shows a green dot when active, and you can right-click any of them to manage it directly.

What Each Agent Actually Does

Memory Agent

This is the hardest-working one. Every 30 minutes it:

Maintenance Agent

The janitor. Once a day at 4 AM it:

Quality Agent

Your quality watchdog. At midnight it:

Vault Agent

Keeps your document library current. At 3 AM it:

Integration Agent

The connectivity monitor. Every 5 minutes it:

What's Next?