71 lines
3.0 KiB
Markdown
71 lines
3.0 KiB
Markdown
# 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)
|