WorkFort Codex

WorkFort is an Arch Linux distribution purpose-built as an office for AI agents. Each agent gets its own Firecracker microVM — a private workspace with full system access — managed by the Nexus daemon.

This codex contains design documents, specifications, and plans for the WorkFort project.

Repositories

Architecture Overview

graph TB
    subgraph Host["Host (Arch Linux, btrfs)"]
        Nexus["nexusd"]
        SQLite["SQLite"]
        Bridge["nexbr0 (172.16.0.0/24)"]

        subgraph Portal["Portal VM"]
            Agent["Agent Runtime"]
        end

        subgraph Work["Work VM"]
            GA["guest-agent (MCP server)"]
            Tools["file R/W/D, run command"]
        end

        subgraph Services["Service VMs (later)"]
            Git["Git Server"]
            Tracker["Project Tracker"]
        end
    end

    Nexus -->|vsock| Portal
    Nexus -->|vsock| Work
    Nexus -->|vsock| Services
    Agent -->|MCP via Nexus| GA
    GA --> Tools
    Portal --- Bridge
    Work --- Bridge
    Services --- Bridge
    Nexus --- SQLite