ZugaMind

What ZugaMind does

Cron wakes an agent on a schedule; ZugaMind wakes it because something happened. It watches configured sources for free, with no model calls while idle, runs a Global Workspace salience competition over what it sees, and wakes the harness with a continuity briefing only when something wins and clears a fail-closed budget gate.

The zugamind command starts a detached daemon that keeps running after the terminal closes, and any terminal can attach to watch it. Subcommands include start, status, watch and stop, plus operator tools doctor, logs, budget, explain and verify --dry-run. An offline demo needs no key or network, and the README reports 262 tests that run without network access. It runs on Linux, macOS and Windows with Python 3.10 to 3.13. Example harness configs sit in examples/harness-configs, and an integration for a shared fix pool called AgentPool is described.

Key features

• Event-driven wake-ups instead of fixed schedules
• Free watching with no model calls while idle
• Fail-closed budget gate
• Detached daemon with start, status, watch and stop
• Doctor, logs, budget and explain commands
• Zero dependencies, Python standard library only

When to use it

• Waking Hermes only when a watched source changes
• Capping how much an always-on agent can spend in a month
• Debugging why a cycle did or did not wake the agent

Who it is for: Developers who run agent harnesses continuously and want to avoid paying for empty wake-ups.

How it fits with Hermes Agent

Hermes is one of the harnesses ZugaMind can wake, alongside Claude Code, OpenClaw, Codex CLI and any CLI process.

How to install ZugaMind

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/Zuga-Technologies/zugamind.git
cd zugamind
python demo.py
pip install -e .

Requirements: Python 3.10+ and git

FAQ