INSTALL

Install the full Alfred fleet.

Use Alfred Desktop for the guided setup, or use the terminal path for a headless Mac or Linux host. Either path installs the full engineering roster: Batman as architect, Drake as planner, Lucius as senior-dev, Ra's al Ghul as reviewer, Bane as test-engineer, Nightwing as fixer, and the reliability jobs underneath.

Download Desktop Terminal install

PICK YOUR STARTING POINT

Choose the path that matches your machine.

The desktop path is the default for most users because it can install or repair core, inspect an existing setup, start the local server, guide auth, and keep setup repairable. The terminal path is still there for headless hosts and people who want every command in front of them.

PATH A · RECOMMENDED

Use Alfred Desktop.

Installs or repairs Alfred core from the app
Detects an existing Alfred runtime and repo checkout
Guides GitHub, Claude Code, Codex, and local server checks
Configures the full fleet without hand-editing prompts
Lets you pick a roster theme or custom display names

Download the app -> PATH B · HEADLESS

Run the terminal install.

Best for Linux servers, scripted setup, and no-GUI installs
Installs dependencies and writes the local runtime
Can be driven by Claude Code or Codex with the assisted guide
Ends with doctor, dry-run, and scheduler checks

Open terminal guide ->

CHECK IT FIRST

Check the setup before real work starts.

The doctor command checks the local runtime. A dry run walks one agent through its startup path without touching GitHub, Slack, an engine, or your files.

 terminal copy   $  alfred doctor  
 ok    gh auth                  luminik-io 
 ok    claude code              authed 
 ok    codex                    authed (optional) 
 ok    launchd                  full fleet loaded 
 ok    spend cap                $20/day fleet 
 
  $  alfred dry-run senior-dev  
 alfred dry-run: senior-dev 
   role: feature dev 
   mode: safe simulation 
   would: resolve config, acquire the agent lock, run preflight, and enter the runner 
   would not: mutate GitHub, post Slack, invoke an engine, or edit files 

WHAT YOU END UP WITH

A full engineering team scheduled on your machine.

The default setup enables the whole local engineering loop. Theme names are visible in Slack and Desktop, while stable role slugs keep the machinery predictable: Drake scopes, Batman coordinates cross-repo work, Lucius builds, Ra's al Ghul reviews, Bane adds coverage, Nightwing fixes high-priority review feedback, Huntress and Gordon watch deploy health, and the reliability jobs keep the system inspectable.

●Drake reads your plans and files small, clear tasks.
●Batman coordinates approved cross-repo rollouts.
●Lucius picks up those tasks and opens pull requests.
●Ra's al Ghul reviews pull requests and runs your tests.
●Bane adds focused coverage where changes need tests.
●Nightwing fixes high-priority review comments on agent-authored PRs.
●Robin keeps quick issue triage moving.
●Huntress watches app health when you provide a target URL.
●Gordon watches ECS deploy health when you provide a cluster.
●Reliability agents handle automerge, memory, code-map, cleanup, reports, and fleet doctor.