agency-agents icon indicating copy to clipboard operation
agency-agents copied to clipboard

docs: replace Quick Start Option 3 with agent-add cross-host install

Open pea3nut opened this issue 3 months ago • 2 comments

Summary

Replaces Option 3: Use with Other Tools in ## ⚡ Quick Start with a one-command agent-add install, so users on Cursor / Windsurf / Claude Desktop / GitHub Copilot / Gemini / Roo Code / OpenCode / etc. (18 hosts total) can install any single agent without cloning the repo or running scripts/convert.sh + scripts/install.sh:

npx -y agent-add --sub-agent 'https://raw.githubusercontent.com/msitarzewski/agency-agents/main/engineering/engineering-backend-architect.md'

Options 1 (Claude Code) and 2 (Reference) are unchanged. The legacy script-based flow is still linked from the new Option 3 pointing at the existing Multi-Tool Integrations section below. Docs-only change.

pea3nut avatar Apr 08 '26 13:04 pea3nut

Hey @pea3nut — agent-add is an interesting tool! Single-command install across 18 hosts is a compelling UX improvement.

However, this PR replaces the existing Quick Start Option 3 (convert.sh + install.sh flow) rather than adding agent-add as an additional option. Our install scripts are well-tested and don't require an external dependency. Replacing them with a third-party tool in the main README is a big commitment.

Could you rework this as an additive Option 4 instead? Something like:

### Option 4: Quick install with agent-add (18+ hosts supported)

That way users get the convenience of agent-add without losing the existing script-based flow. Would also be good to open a Discussion first since this adds a third-party dependency to the recommended install path. Thanks!

msitarzewski avatar Apr 12 '26 04:04 msitarzewski

Thanks for the feedback! Reworked as requested — agent-add is now an additive Option 4, and Options 1-3 are fully restored to their original content.

pea3nut avatar Apr 12 '26 08:04 pea3nut