Firecracker microVM-based multi-agent system with IRC orchestration and local LLMs. Features: - Ephemeral command runner with VM snapshots (~1.1s) - Multi-agent orchestration via overseer IRC bot - 5 agent templates (worker, coder, researcher, quick, creative) - Tool access (shell + podman containers inside VMs) - Persistent workspace + memory system (MEMORY.md pattern) - Agent hot-reload (model/persona swap via SSH + SIGHUP) - Non-root agents, graceful shutdown, crash recovery - Agent-to-agent communication via IRC - DM support, /invite support - Systemd service, 20 regression tests Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1.8 KiB
1.8 KiB
TODO
Done
- Firecracker CLI runner with snapshots (~1.1s)
- Alpine rootfs with ca-certificates, podman, python3
- Global
fireclawcommand - Multi-agent system — overseer + agent VMs + IRC + Ollama
- 5 agent templates (worker, coder, researcher, quick, creative)
- 5 Ollama models (qwen2.5-coder, qwen2.5, llama3.1, gemma3, phi4-mini)
- Agent tool access — shell commands + podman containers
- Persistent workspace + memory system (MEMORY.md pattern)
- Agent hot-reload — model/persona swap via SSH + SIGHUP
- Non-root agents — unprivileged
agentuser - Agent-to-agent via IRC mentions (10s cooldown)
- DM support — private messages, no mention needed
- /invite support — agents auto-join invited channels
- Channel layout — #control (commands), #agents (common), DMs
- Overseer resilience — crash recovery, agent adoption
- Graceful shutdown — IRC QUIT before VM kill
- Systemd service (KillMode=process)
- Regression test suite (20 tests)
Next up
- Network policies per agent — restrict internet access
- Warm pool — pre-booted VMs for instant agent spawns
- Persistent agent memory improvements — richer memory structure, auto-save from conversations
- Thin provisioning — device-mapper snapshots instead of full rootfs copies
Polish
- Fix trigger matching — only trigger when nick is at the start of the message, not anywhere in text. Currently "say hi to worker" triggers worker even when addressed to another agent.
- Cost tracking per agent interaction
- Execution recording / audit trail
- Agent health checks — overseer pings agents, restarts dead ones
- Thread safety in agent.py — lock around IRC socket writes
- Update regression tests for new channel layout