Install, preview, and run a profile.

The shortest path from a source repository to a working agent profile in your harness.

Four steps

Start with a dry run.

1

Inspect source profiles

npx awesome-agents add owner/repo --list
2

Preview writes

npx awesome-agents add owner/repo --agent triage-agent --dry-run
3

Install the profile

npx awesome-agents add owner/repo --agent triage-agent
4

Run it

codex --profile triage-agent
claude --agent triage-agent
opencode

Local development

Use a checkout while authoring profiles.

npm install
npm test
node ./bin/awesome-agents.js add ./test/fixtures/profile-source --agent triage-agent --dry-run