Alfred
INSTALL
Install Alfred for your current setup.
Fast path for an already-provisioned dev machine. Guided path for a fresh laptop, Mac mini, Linux server, or dedicated agent box.
PICK YOUR STARTING POINT
Choose the path that matches your machine.
The fast path assumes your developer tools are already authenticated. The guided path walks through prerequisites, auth, and the first Alfred run.
PATH A · ~30 MIN
Use an existing dev setup.
- GitHub CLI is already authenticated
- Claude Code first run is complete
- Homebrew on macOS or apt on Linux
- Python 3.11+ on PATH
Set up a fresh machine.
- Fresh laptop or dedicated box
- No GitHub auth, no CLIs installed
- Guided prompt for Claude Code
- Every repo and secret is confirmed explicitly
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.
$ alfred doctor
ok gh auth luminik-io
ok claude code authed
ok codex authed (optional)
ok launchd 21 agents loaded
ok spend cap $20/day fleet
$ alfred dry-run lucius
alfred dry-run: lucius
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
One repo, four agents, scheduled on your machine.
The default setup gives you four agents to start: Drake, Lucius, Ra's al Ghul, and a cleanup agent. Lucius checks for implementation work every 20 minutes; the other agents follow their own cadences. Add Batman, Bane, and Nightwing when you are ready for them.
- ●Drake reads your plans and files small, clear tasks.
- ●Lucius picks up those tasks and opens pull requests.
- ●Ra's al Ghul reviews pull requests and runs your tests.
- ●Cleanup tidies up leftover repo copies and branches.