Files
fireclaw/TODO.md
ansible ff694d12f6 Initial commit — fireclaw multi-agent system
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>
2026-04-07 13:28:29 +00:00

1.8 KiB

TODO

Done

  • Firecracker CLI runner with snapshots (~1.1s)
  • Alpine rootfs with ca-certificates, podman, python3
  • Global fireclaw command
  • 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 agent user
  • 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