aiL

Documentation

aiL is not public yet; the docs come first. Start with the concepts and the method, then read each contract.

Start

IntroductionWhat aiL is, what it solves, and what it is made of. ConceptsThe things in the system and how they connect. MethodologyThe nine principles and three red lines used to judge a design.

System

ArchitectureComposition, the split between Desk and Daemon, where plugins and data live, connection and authorization, disconnects and restarts. The Worker contractEvery harness session is the same Worker. Definitions, operations, a turn, identity and unattended running. Across machinesCompute apart from environment, remote workspaces, and running PowerShell or Bash on another machine.

Work

Workflows and the engineIntents, workflows and runs; how the report block drives hand-offs; wake-ups, review gates, closing, worktrees, maps and the Journal. RouterThe one you talk to. It judges and never executes. The contract, how it is delivered, the guard and the notification queue. ReportsThe two kinds of page a Worker pushes to you, and how they are grouped, answered, withdrawn and shared.

Operate

PluginsThe main repository, Repo registrations and the official plugin; the seed, sync, and how changes take effect. Command lineThe conventions of ail and all its subcommands. Agents and you use the same ones. Install and upgradeInstalling aiL as a resident service, pairing each machine, upgrading and rolling back.