The Problem
Every agentic tool has its own folder convention. Cursor expects rules in .cursor/rules/. Copilot wants agents in ~/.github/agents/. Claude Code reads from ~/.claude/agents/. Finding a good agent, converting the markdown, and dropping it in the right place is a ritual nobody wants to repeat, especially when switching between tools or onboarding a team.
What It Does
agency-cli is a Go CLI that connects to The Agency (a curated collection of AI agents) and installs any of them into your tool of choice.
Run agency-cli for the interactive TUI, or use subcommands to script it into your workflow.
Interactive TUI
The TUI walks you through a four-step flow:
- Browse agents: navigate by category or type to search across all agents
- Select a tool: choose your target (Cursor, Copilot, Claude Code, etc.)
- Choose scope: local project or global user, where applicable
- Install: the agent is converted and placed in the correct location automatically
Filtering is smart: results rank by exact name match → prefix → contains → description/category.
Keyboard Shortcuts
| Key | Action |
|---|---|
↑ / ↓ or j / k | Navigate list |
← / → | Switch categories |
| Type any character | Filter / search |
Backspace | Delete last filter character |
Esc | Clear filter / go back |
Enter | Confirm selection |
q | Quit (when not filtering) |
Ctrl+C | Quit at any time |
How It Works
On first run, agency-cli clones the agency-agents repository to ~/.cache/agency-cli/agency-agents/. Subsequent runs read from this local cache. When you install an agent, the CLI converts the markdown to the target tool's expected format and writes it to the correct path.
agency-agents repo (GitHub)
│
▼ agency-cli sync
~/.cache/agency-cli/agency-agents/
│
▼ agency-cli get <agent> --tool <tool>
tool-specific destination
Installation
go install github.com/caioreix/agency-cli@latest
Usage
# Interactive TUI
agency-cli
# Pre-select a tool and skip that step
agency-cli --tool cursor
# List all agents
agency-cli list
# Filter by category
agency-cli list --category engineering
# Install a specific agent
agency-cli get code-reviewer --tool cursor
agency-cli get frontend-developer --tool copilot
# Update the local agent cache
agency-cli sync
# List all supported tools
agency-cli tools
Supported Tools
| Tool | Destination | Scope |
|---|---|---|
claude-code | ~/.claude/agents/ | user |
copilot | ~/.github/agents/ + ~/.copilot/agents/ | user |
cursor | .cursor/rules/ | project |
windsurf | .windsurfrules | project |
aider | CONVENTIONS.md | project |
opencode | .opencode/agents/ | project |
openclaw | ~/.openclaw/agency-agents/ | user |
antigravity | ~/.gemini/antigravity/skills/ | user |
gemini-cli | ~/.gemini/extensions/agency-agents/ | user |
qwen | .qwen/agents/ | project |
If you work across multiple agentic tools or want your whole team wired up in seconds, install agency-cli and stop managing agent files by hand.
Comments