User Guide

Install, configure, and run your first multi-agent workflow in under five minutes.

Quick Links

• Usage — CLI commands, API reference, example workflows
• Configuration — Profile setup, driver options, retry settings
• Troubleshooting — Common issues and solutions

Getting Started

1. Install Amelia

   uv tool install git+https://github.com/existential-birds/amelia.git

2. Create a profile:

   amelia config profile create dev --driver claude --tracker none --activate

3. Run your first workflow:

   amelia plan 123  # Generate plan for issue #123

   You should see the Architect agent generate an implementation plan for review.

What's Next

• Usage Guide — all the CLI commands you'll actually use
• Configuration — drivers and trackers for your environment
• Architecture — how the agents work