# Fireclaw Roadmap

## Phase 1: Core CLI (done)

- [x] Firecracker microVM lifecycle (boot, exec, destroy)
- [x] SSH-based command execution
- [x] Network isolation (tap + bridge + NAT)
- [x] IP pool management for concurrent VMs
- [x] Signal handling and cleanup
- [x] CLI interface (`fireclaw run`, `fireclaw setup`)

## Phase 2: Fast & Useful (done)

- [x] Alpine Linux rootfs (1 GiB sparse, 146 MiB on disk)
- [x] Precompiled binary, global `fireclaw` command
- [x] Snapshot & restore (~1.1s vs ~2.9s cold boot)

## Phase 3: Multi-Agent System (done)

- [x] ngircd configured (`nyx.fireclaw.local`, FireclawNet)
- [x] Channel layout: #control (overseer), #agents (common room), DMs, /invite
- [x] Ollama with 5+ models, hot-swappable per agent
- [x] Agent rootfs — Alpine + Python IRC bot + podman + tools
- [x] Agent manager — start/stop/list/reload long-running VMs
- [x] Overseer — !invoke, !destroy, !list, !model, !models, !templates, !status, !help
- [x] 5 agent templates — worker, coder, researcher, quick, creative
- [x] Agent tools — run_command, web_search (searx), save_memory
- [x] Persistent workspace — 64 MiB ext4 as second virtio drive
- [x] Agent memory system — MEMORY.md pattern, survives restarts
- [x] Agent hot-reload — model/persona swap via SSH + SIGHUP
- [x] Non-root agents — unprivileged `agent` user
- [x] Agent-to-agent via IRC, DMs, /invite
- [x] Overseer resilience — crash recovery, health checks, KillMode=process
- [x] Graceful shutdown — IRC QUIT before VM kill
- [x] Systemd service, regression tests

## Phase 4: Hardening & Deployment (done)

- [x] Network policies per agent — full/local/none via iptables
- [x] Thread safety — lock around IRC socket writes
- [x] Agent health checks — 30s interval, announces deaths in #control
- [x] Trigger matching fix — start-of-message only
- [x] agents.json race condition fix
- [x] Install script — one-command deployment, battle-tested on Debian + Ubuntu
- [x] Uninstall script
- [x] Deployed on GPU server (Xeon + Quadro P5000)
- [x] Refactor — shared firecracker-vm.ts helpers, -43 lines

### Remaining
- [ ] Warm pool — pre-booted VMs from snapshots for instant spawns
- [ ] Concurrent snapshot runs via network namespaces
- [ ] Thin provisioning — device-mapper snapshots instead of full rootfs copies

## Phase 5: Advanced Features

- [ ] Scheduled/cron tasks — agents that run on a timer
- [ ] !logs command — tail agent interaction history
- [ ] Persistent agent memory v2 — richer structure, auto-save
- [ ] Advanced tool use — MCP servers in Firecracker VMs
- [ ] Cost tracking — duration, model, tokens per interaction
- [ ] Execution recording — audit trail

## Phase 6: Ideas & Experiments

See IDEAS.md for the full list. Highlights:
- MCP servers as a single Firecracker VM with podman containers
- Cron agents, webhook triggers, alert forwarding
- Agent-written agents, agent debates, dream mode
- Web dashboard, install script dry-run
- Persistent agent memory with CLAUDE.md pattern (v2)