How cirofarje/agency-agents-app works
Agency Agents is a local-first native desktop app for browsing agent personas, rendering them for supported coding tools, and managing tracked installs. Its primary workflow runs from the Agents workspace through the Tauri IPC boundary to the Rust corpus, renderer, and install ledger; the Tools, Teams, Projects, dashboard, GitHub, settings, and updater capabilities form complementary branches. Several frontend feature modules and command handlers are unsampled, so their implementation-level connections are shown only where the README or source index documents them.
Main entry points: install/mod.rs Install and reconcile · api.ts Frontend API · corpus/mod.rs Corpus service · lib.rs Tauri app entry
Components 25
App workspace
- Tauri app entry
src-tauri/src/lib.rs - Svelte app shell
src/routes/+page.svelte - Agents workspace
src/lib/components/AgentsWorkspace.svelte - Tools panel
src/lib/components/ToolsView.svelte - Teams
src/lib/components/Teams.svelte - Projects
src/lib/components/Projects.svelte - Dashboard views
src/lib/components/AgencyDashboard.svelte - Frontend API
src/lib/api.ts - Frontend stores
src/lib/stores/install.svelte.ts
Catalog and discovery
- Corpus service
src-tauri/src/corpus/mod.rs - Persona parser
src-tauri/src/corpus/parse.rs - Bundled corpus
src-tauri/src/corpus/mod.rs
Install management
- Tool registry
src-tauri/src/registry.rs - Tool renderer
src-tauri/src/render/mod.rs - Install and reconcile
src-tauri/src/install/mod.rs - Install ledger
src-tauri/src/install/mod.rs
Native services
- Settings commands
src-tauri/src/commands/settings.rs - Settings state
src-tauri/src/state.rs
External integrations
- GitHub integration
src-tauri/src/github/mod.rs - Device Flow auth
src-tauri/src/github/auth.rs - Updater commands
src-tauri/src/commands/updater.rs - GitHub
- Update service
Other components
- User
- Coding tools
Connections 21
- User → Svelte app shell: uses
README.md - Svelte app shell → Tauri app entry: invokes over IPC
README.md - Tauri app entry → Corpus service: registers commands
src-tauri/src/lib.rs - Agents workspace → Frontend API: requests catalog and installs
- Tools panel → Frontend API: requests tool status
- Teams → Frontend API: deploys team
- Projects → Frontend API: manages project installs
- Dashboard views → Frontend stores: shows install health
- Frontend API → Tauri app entry: calls Tauri commands
README.md - Corpus service → Persona parser: parses personas
src-tauri/src/corpus/mod.rs - Corpus service → Bundled corpus: loads and refreshes
README.md - Install and reconcile → Corpus service: reads source
src-tauri/src/install/mod.rs - Install and reconcile → Tool renderer: renders and reconciles
src-tauri/src/install/mod.rs - Tool renderer → Tool registry: resolves tool formats
src-tauri/src/render/mod.rs - Install and reconcile → Tool registry: detects supported tools
src-tauri/src/install/mod.rs - Install and reconcile → Install ledger: tracks installs
README.md - Settings commands → Settings state: updates persisted state
src-tauri/src/state.rs - GitHub integration → Device Flow auth: provides Device Flow
src-tauri/src/github/mod.rs - Device Flow auth → GitHub: authenticates with
src-tauri/src/github/auth.rs - Updater commands → Update service: checks and installs updates
src-tauri/src/commands/updater.rs - Install and reconcile → Coding tools: writes rendered agents
README.md