Fast checks for common failures.

Most install issues are source selection, harness detection, or safety-marker problems.

←

Checks

Start with the exact error.

No harness detected: Pass --harness codex, --harness claude-code, --harness opencode, --harness goose, or --harness tenex-edge.
Profile not found: Run npx awesome-agents add <source> --list and confirm the slug under agents/<slug>/.
Existing unmanaged file: The CLI found a target file without the generated marker. Inspect it, move it, or intentionally pass --force.
Codex cannot find the profile: Run codex --profile <profile> with the plain profile name. Do not pass a file path.