winget install --id=msitarzewski.AgencyAgents -e Agency Agents is a small, native app for browsing, installing, and tracking the agent personas from msitarzewski/agency-agents across the AI coding tools you actually use.
> A native installer for AI agents.
Agency Agents is a small, native app for browsing, installing, and tracking the agent personas from msitarzewski/agency-agents across the AI coding tools you actually use.
It is full source, MIT-licensed, local-first, and does not run telemetry.
The agency-agents repo is a useful catalog of specialist AI agent personas, but every coding tool has its own agent format and install path. Claude Code, Codex, Cursor, Gemini CLI, Qwen, opencode, Copilot, and Osaurus all want similar content in slightly different places.
Agency Agents gives that catalog a native control surface:
The core idea is simple: AI tools do not share a package database, so the app keeps the local install database they are missing.
Agency Agents is organized around four pillars — Agents (who), Tools (how), Teams (which), and Projects (where):
tools.json shared by the backend and frontend; adding a tool is editing one JSON entry, and installability is derived from whether the app ships a renderer for that tool's format.agency-agents.New to directing agents? See docs/USING-AGENTS.md — the Playbook: how to get shipped, tested work out of the catalog (also in-app via the title-bar book icon).
The app currently installs to the renderer-backed targets that have deterministic byte parity with the upstream agency-agents converter:
| Tool | Scope Today | Output |
|---|---|---|
| Claude Code | user | ~/.claude/agents/*.md |
| Codex | user | ~/.codex/agents/*.toml |
| Gemini CLI | user | ~/.gemini/agents/*.md |
| GitHub Copilot | user | ~/.github/agents/*.md and ~/.copilot/agents/*.md |
| Qwen Code | user | ~/.qwen/agents/*.md |
| Cursor | project | .cursor/rules/*.mdc |
| opencode | project | .opencode/agents/*.md |
| Osaurus | user | ~/.osaurus/skills/agency-/SKILL.md |
The upstream AA repo also contains integrations for Antigravity, Aider, Windsurf, OpenClaw, and Kimi. Those output shapes need additional app work before they should be exposed as first-class app installs — they appear in the Tools panel as recognized-only.
agency-agents repo. The repo remains the source catalog.Grab the build for your platform from the latest release:
.dmg, macOS 13+..deb, .rpm, or the portable .AppImage..exe installer (not code-signed yet; SmartScreen → More info → Run anyway).Or on macOS via Homebrew:
brew tap msitarzewski/agency-agents
brew install --cask agency-agents
For local review, use the development app:
npm install
npm run tauri dev
For a signed release build on macOS, see docs/BUILD.md.
Prerequisites:
xcode-select --installThen:
git clone https://github.com/msitarzewski/agency-agents-app
cd agency-agents-app
npm install
npm run tauri dev
npm run check
cargo test --manifest-path src-tauri/Cargo.toml --lib
npm run build
The Phase C local QA batch is:
npm run build:phase-c
Use the full VM-assisted batch when the configured Ubuntu/Windows test environments are available:
npm run build:phase-c:full
A Tauri 2 shell hosts a SvelteKit + Svelte 5 frontend in the system WebView. The Rust backend owns the catalog, renderer, install ledger, reconciliation, GitHub integration, settings, and updater boundary.
The catalog comes from agency-agents, either as:
~/.agency-agents/Users/michael/Software/AgentLand/agency-agentsRendering is native Rust, deterministic, and tested against the upstream scripts/convert.sh outputs for the supported transform tools. The app does not shell out to converter scripts at runtime.
Important implementation areas:
Memory Bank design context lives under memory-bank/. Start with memory-bank/projectbrief.md, memory-bank/systemPatterns.md, and memory-bank/NEXT-SESSION.md.
Core browsing and install tracking are local. Network access is explicit and gated by Settings.
Known outbound paths:
agency-agents catalog when the user requests or enables it.No telemetry, crash reporting, advertising pixels, or product analytics are included.
Agency Agents uses typed Tauri IPC commands and avoids tauri-plugin-shell. File writes are restricted to known install destinations, app state, backups, and user-selected paths. Modified installed files are backed up before destructive operations.
Report vulnerabilities using SECURITY.md.
Contributions are welcome. See CONTRIBUTING.md.
The highest-value areas before 1.0 are:
MIT. Do whatever you want with this.
tools.json tool manifest (the twin of divisions.json) landed there first.If Agency Agents saves you time, consider sponsoring on GitHub. Sponsorship is optional and does not unlock a paid tier.