CodeVetter · Repo Unpack · Feature catalog
msitarzewski/agency-agents
User-facing surface is the agent roster, the installer CLI, the converter, NEXUS orchestration docs, and a handful of optional integrations (MCP memory, Chinese Copilot name localization). Agents are activated by pasting or installing their markdown into a host tool, not by an in-repo UI. The installer can target one tool, a division, a slug list, or an agents file, and can dry-run. Hermes exposes four router tools instead of one skill per agent.
- install.sh usage supports --tool (comma-separated), --division, --agent, --agents-file, --link, --path, --interactive/--no-interactive, --no-convert, --dry-run, --list [tools|teams|agents], --parallel, and --jobs. Bare invocation installs all teams into detected tools and opens the wizard on a TTY.
- Interactive install is a three-screen TUI: screen_tools, screen_teams, screen_review. Keys are space/a/n/search/enter. Teams default to all; tools default to whatever is_detected returns. Review toggles copy vs symlink via USE_LINK.
- Claude Code install copies source markdown into ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/agents (or $CLAUDE_CONFIG_DIR/agents). Copilot copies the same files into both ~/.github/agents and ~/.copilot/agents. Neither tool is produced by convert.sh.
- Project-scoped installs write into the current working directory: OpenCode to .opencode/agents, Cursor to .cursor/rules, Aider to CONVENTIONS.md, Windsurf to .windsurfrules. User-scoped examples include Gemini ~/.gemini/agents, Codex ~/.codex/agents, OpenClaw ~/.openclaw/agency-agents, Osaurus ~/.osaurus/skills.
- convert.sh --tool accepts antigravity, gemini-cli, opencode, cursor, aider, windsurf, openclaw, qwen, zcode, kimi, codex, osaurus, hermes, vibe, or all. Per-agent converters include convert_opencode, convert_cursor, convert_codex, convert_kimi, convert_vibe, convert_openclaw, convert_qwen, convert_zcode.
- Aider output is an index, not full prompts: accumulate_aider writes name, description, division, and a repo-relative source path because inlining every body would be about 3.8 million characters. Windsurf's accumulate_windsurf does inline every body into one .windsurfrules file.
- OpenClaw conversion splits each body into SOUL.md (headers matching identity, learning/memory, communication, style, critical rules) versus AGENTS.md (everything else) plus IDENTITY.md from emoji and vibe. install_openclaw registers new workspaces with openclaw agents add when the binary exists.
- The Hermes plugin exposes exactly four tools: agency_agents_search (query, optional division and limit), agency_agents_inspect (agent or slug, include_body), agency_agents_load (agent or slug, task), and agency_agents_delegate (agent or slug, required task). The committed README records a generated count of 279.
- NEXUS is the multi-agent orchestration layer in strategy/. QUICKSTART.md defines NEXUS-Full (all agents, 12-24 weeks), NEXUS-Sprint (15-25 agents, 2-6 weeks), and NEXUS-Micro (5-10 agents, 1-5 days), activated by prompting Agents Orchestrator.
- strategy/runbooks.json is the machine-readable roster the desktop app uses for one-click team deploy. Shipped scenarios include startup-mvp, enterprise-feature, and the docs scenario-incident-response.md and scenario-marketing-campaign.md. Each runbook has slug, title, mode, doc, and grouped agents with activation.
- MCP memory is an optional, non-installing integration. integrations/mcp-memory/setup.sh only prints instructions and looks for ~/.config/claude/mcp.json, ~/.cursor/mcp.json, or .mcp.json. It expects an external server exposing remember, recall, rollback, and search.
- Chinese localization is a post-install PowerShell step, scripts/i18n/localize-agents-zh.ps1, driven by scripts/i18n/agent-names-zh.json. It rewrites name and description in installed Copilot files under %USERPROFILE%\.github\agents and %USERPROFILE%\.copilot\agents.
- Selection files are supported. scripts/agents-to-install.example lists frontend-developer, backend-architect, security-architect, and the display name Penetration Tester. --agents-file strips comments and blank lines, slugifies each line, and exits 1 on an unknown agent.
- OpenCode has a product-level capacity warning. tool_cap returns 119 only for opencode, citing upstream anomalyco/opencode#27988. The wizard and dry-run both warn when the selected agent count exceeds that cap.