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>
This commit is contained in:
2026-04-07 13:28:29 +00:00
commit ff694d12f6
28 changed files with 5917 additions and 0 deletions

24
src/types.ts Normal file
View File

@@ -0,0 +1,24 @@
export interface VMConfig {
id: string;
guestIp: string;
tapDevice: string;
socketPath: string;
rootfsPath: string;
timeoutMs: number;
verbose: boolean;
}
export interface RunResult {
exitCode: number;
stdout: string;
stderr: string;
durationMs: number;
}
export interface RunOptions {
timeout?: number;
verbose?: boolean;
mem?: number;
vcpu?: number;
noSnapshot?: boolean;
}