Agency Agents v0.2.0
Agency Agents v0.2.0 — 2026-06-22
The first feature release since the public launch. This is a large one: it reorganizes the app
around a four-pillar model, makes tool knowledge a single source of truth, wires a new install
target (Osaurus), and adds an in-app Playbook for getting real work out of the catalog.
This rolls up everything developed after v0.1.0 (the milestones tracked internally as 0.1.1 and
0.1.2 were never cut as separate releases — they ship here).
Downloads
- macOS (Apple Silicon & Intel) — signed + notarized
.dmg, launches without warnings. macOS 13+. - Linux (x86_64) —
.deb(Debian/Ubuntu),.rpm(Fedora/RHEL/openSUSE), or the portable.AppImage. - Windows (x64 & ARM64) —
.exeinstaller. Not code-signed yet, so SmartScreen warns on first launch → click More info → Run anyway (see Known Notes).
Or visit agencyagents.app.
Highlights
A four-pillar information architecture — Agents / Tools / Teams / Projects (who / how / which / where):
- Divisions landing — the catalog now opens on its divisions, with an install-state lens (installed / not-installed / all) layered across the workspace.
- Teams (renamed from Loadouts) — app-bundled preset teams plus your own saved teams; click a team for a detail panel with Deploy built in.
- Projects pillar — project-scoped installs with a dedicated Projects panel and master/detail navigation driven by the system back arrow.
- Unified install surface — a single destinations × tools Install grid reused everywhere, plus a two-pane Deploy browser grouped by division.
Tool registry — a single source of truth:
- Tool knowledge now lives in one upstream-owned
tools.json(the twin of the catalog'sdivisions.json), read by both the Rust backend and the frontend. The RustToolenum is gone — a tool is an id, and the renderer dispatches on aformatkey. Adding a tool is now editing one JSON file. - All 13 recognized tools are modeled and shown in the Tools panel; installable targets render in full, recognized-only targets appear dimmed. Installability is derived from whether the app ships a renderer for the tool's format — nothing to hand-sync.
- Real brand logos for tools, vendored from Lobe Icons (MIT).
Osaurus support:
- A new
skill-mdrenderer installs catalog agents as native Osaurus skills (~/.osaurus/skills/agency-<slug>/SKILL.md), byte-identical to the upstream converter. That brings the installable target count to 8.
Playbook:
- An in-app Playbook (title-bar book icon / ⌘K) with best practices and copyable starter prompts for directing the catalog, plus per-team and per-division examples. Also documented in docs/USING-AGENTS.md.
Dashboard:
- A two-ring Global-vs-Projects install sunburst so the totals reconcile, cross-tool coverage merged with the catalog-by-division view into one card with linked hover, and uniform donut sizing.
Auto-update goes live:
- This release activates the in-app updater. It publishes a signed manifest at
agencyagents.app/updater.json(signed with a dedicated agency key), and the app checks for new versions and offers a one-click download → verify → install → relaunch, surfaced via a title-bar indicator and Settings → Updates. Because v0.2.0 is the first build with a live endpoint, the first delivered update will be the next release — a v0.2.0 user checking now correctly sees "up to date." Fully hands-off automatic install (the "Install updates automatically" toggle) is present but still disabled; opt-in auto-install lands later.
Quality Gates
cargo test --lib(264 passing, incl. renderer byte-parity)npm run check(0 errors)npm run build- ignored renderer parity test against the active
agency-agentsclone - Phase C platform-config validation
- full cross-platform build matrix (macOS + Ubuntu deb/rpm/appimage + Windows x64/arm64)
Known Release Notes
- The app is not an agent runtime — it installs personas into other tools; it does not execute them.
- Five upstream targets remain recognized-only (Antigravity, Aider, Windsurf, OpenClaw, Kimi); they need additional renderer work before they're exposed as first-class installs.
- CLI-installed Osaurus skills are not yet auto-detected by Foreign-sweep; app-installed ones are tracked normally.
- Windows: the build is not code-signed yet. On first launch Microsoft Defender SmartScreen will show
"Windows protected your PC". To run it: click More info → Run anyway. - Auto-update is live (new in 0.2.0). The app fetches a signed manifest from
agencyagents.app/updater.jsonand offers one-click install + relaunch when a newer version is
published. v0.1.0 users upgrade to v0.2.0 manually (the older build predates the live endpoint and the
dedicated signing key); auto-update is real from v0.2.0 forward. Fully hands-off automatic install (the
"Install updates automatically" toggle) is present but disabled — opt-in auto-install lands later.