# cirofarje/agency-agents-app architecture

> Architecture diagram of the GitHub repository cirofarje/agency-agents-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cirofarje/agency-agents-app
- Repository: https://github.com/cirofarje/agency-agents-app

## Overview

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: [`src-tauri/src/install/mod.rs`](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/install/mod.rs) (Install and reconcile), [`src/lib/api.ts`](https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/api.ts) (Frontend API), [`src-tauri/src/corpus/mod.rs`](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/corpus/mod.rs) (Corpus service), [`src-tauri/src/lib.rs`](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/lib.rs) (Tauri app entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["App workspace"]
  node_app["Tauri app entry<br/>[lib.rs]"]
  node_frontend["Svelte app shell<br/>[+page.svelte]"]
  node_agents_ui["Agents workspace"]
  node_tools_ui["Tools panel<br/>[ToolsView.svelte]"]
  node_teams_ui["Teams<br/>[Teams.svelte]"]
  node_projects_ui["Projects<br/>[Projects.svelte]"]
  node_dashboard["Dashboard views"]
  node_api["Frontend API<br/>[api.ts]"]
  node_stores["Frontend stores<br/>[install.svelte.ts]"]
end

subgraph group_catalog["Catalog and discovery"]
  node_corpus["Corpus service<br/>[mod.rs]"]
  node_parser["Persona parser<br/>[parse.rs]"]
  node_catalog_cache["Bundled corpus<br/>[mod.rs]"]
end

subgraph group_deployment["Install management"]
  node_registry["Tool registry<br/>[registry.rs]"]
  node_renderer["Tool renderer<br/>[mod.rs]"]
  node_installer["Install and reconcile<br/>[mod.rs]"]
  node_ledger[("Install ledger<br/>[mod.rs]")]
end

subgraph group_platform["Native services"]
  node_settings["Settings commands<br/>[settings.rs]"]
  node_settings_store["Settings state<br/>[state.rs]"]
end

subgraph group_integrations["External integrations"]
  node_github["GitHub integration<br/>[mod.rs]"]
  node_github_auth["Device Flow auth<br/>[auth.rs]"]
  node_updater["Updater commands<br/>[updater.rs]"]
  node_github_service(("GitHub"))
  node_update_service(("Update service"))
end

node_user(("User"))
node_tool_targets(("Coding tools"))

node_user -->|"uses"| node_frontend
node_frontend -->|"invokes over IPC"| node_app
node_app -->|"registers commands"| node_corpus
node_agents_ui -.->|"requests catalog and installs"| node_api
node_tools_ui -.->|"requests tool status"| node_api
node_teams_ui -.->|"deploys team"| node_api
node_projects_ui -.->|"manages project installs"| node_api
node_dashboard -.->|"shows install health"| node_stores
node_api -->|"calls Tauri commands"| node_app
node_corpus -->|"parses personas"| node_parser
node_corpus -->|"loads and refreshes"| node_catalog_cache
node_installer -->|"reads source"| node_corpus
node_installer -->|"renders and reconciles"| node_renderer
node_renderer -->|"resolves tool formats"| node_registry
node_installer -->|"detects supported tools"| node_registry
node_installer -->|"tracks installs"| node_ledger
node_settings -->|"updates persisted state"| node_settings_store
node_github -->|"provides Device Flow"| node_github_auth
node_github_auth -->|"authenticates with"| node_github_service
node_updater -->|"checks and installs updates"| node_update_service
node_installer -->|"writes rendered agents"| node_tool_targets

click node_app "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/lib.rs"
click node_frontend "https://github.com/cirofarje/agency-agents-app/blob/main/src/routes/%2Bpage.svelte"
click node_agents_ui "https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/AgentsWorkspace.svelte"
click node_tools_ui "https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/ToolsView.svelte"
click node_teams_ui "https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/Teams.svelte"
click node_projects_ui "https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/Projects.svelte"
click node_dashboard "https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/AgencyDashboard.svelte"
click node_api "https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/api.ts"
click node_stores "https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/stores/install.svelte.ts"
click node_corpus "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/corpus/mod.rs"
click node_parser "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/corpus/parse.rs"
click node_catalog_cache "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/corpus/mod.rs"
click node_registry "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/registry.rs"
click node_renderer "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/render/mod.rs"
click node_installer "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/install/mod.rs"
click node_ledger "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/install/mod.rs"
click node_settings "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/commands/settings.rs"
click node_settings_store "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/state.rs"
click node_github "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/github/mod.rs"
click node_github_auth "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/github/auth.rs"
click node_updater "https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/commands/updater.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_frontend,node_agents_ui,node_tools_ui,node_teams_ui,node_projects_ui,node_dashboard,node_api,node_stores,node_user toneBlue
class node_corpus,node_parser,node_catalog_cache toneAmber
class node_registry,node_renderer,node_installer,node_ledger toneMint
class node_settings,node_settings_store toneRose
class node_github,node_github_auth,node_updater,node_github_service,node_update_service,node_tool_targets toneIndigo
```

## Components

### App workspace

- [Tauri app entry](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Svelte app shell](https://github.com/cirofarje/agency-agents-app/blob/main/src/routes/%2Bpage.svelte): `src/routes/+page.svelte`
- [Agents workspace](https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/AgentsWorkspace.svelte): `src/lib/components/AgentsWorkspace.svelte`
- [Tools panel](https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/ToolsView.svelte): `src/lib/components/ToolsView.svelte`
- [Teams](https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/Teams.svelte): `src/lib/components/Teams.svelte`
- [Projects](https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/Projects.svelte): `src/lib/components/Projects.svelte`
- [Dashboard views](https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/components/AgencyDashboard.svelte): `src/lib/components/AgencyDashboard.svelte`
- [Frontend API](https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [Frontend stores](https://github.com/cirofarje/agency-agents-app/blob/main/src/lib/stores/install.svelte.ts): `src/lib/stores/install.svelte.ts`

### Catalog and discovery

- [Corpus service](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/corpus/mod.rs): `src-tauri/src/corpus/mod.rs`
- [Persona parser](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/corpus/parse.rs): `src-tauri/src/corpus/parse.rs`
- [Bundled corpus](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/corpus/mod.rs): `src-tauri/src/corpus/mod.rs`

### Install management

- [Tool registry](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/registry.rs): `src-tauri/src/registry.rs`
- [Tool renderer](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/render/mod.rs): `src-tauri/src/render/mod.rs`
- [Install and reconcile](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/install/mod.rs): `src-tauri/src/install/mod.rs`
- [Install ledger](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/install/mod.rs): `src-tauri/src/install/mod.rs`

### Native services

- [Settings commands](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/commands/settings.rs): `src-tauri/src/commands/settings.rs`
- [Settings state](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/state.rs): `src-tauri/src/state.rs`

### External integrations

- [GitHub integration](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/github/mod.rs): `src-tauri/src/github/mod.rs`
- [Device Flow auth](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/github/auth.rs): `src-tauri/src/github/auth.rs`
- [Updater commands](https://github.com/cirofarje/agency-agents-app/blob/main/src-tauri/src/commands/updater.rs): `src-tauri/src/commands/updater.rs`
- **GitHub**
- **Update service**

### Other components

- **User**
- **Coding tools**

## Connections

- User → Svelte app shell: uses (evidence: `README.md`)
- Svelte app shell → Tauri app entry: invokes over IPC (evidence: `README.md`)
- Tauri app entry → Corpus service: registers commands (evidence: `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 (evidence: `README.md`)
- Corpus service → Persona parser: parses personas (evidence: `src-tauri/src/corpus/mod.rs`)
- Corpus service → Bundled corpus: loads and refreshes (evidence: `README.md`)
- Install and reconcile → Corpus service: reads source (evidence: `src-tauri/src/install/mod.rs`)
- Install and reconcile → Tool renderer: renders and reconciles (evidence: `src-tauri/src/install/mod.rs`)
- Tool renderer → Tool registry: resolves tool formats (evidence: `src-tauri/src/render/mod.rs`)
- Install and reconcile → Tool registry: detects supported tools (evidence: `src-tauri/src/install/mod.rs`)
- Install and reconcile → Install ledger: tracks installs (evidence: `README.md`)
- Settings commands → Settings state: updates persisted state (evidence: `src-tauri/src/state.rs`)
- GitHub integration → Device Flow auth: provides Device Flow (evidence: `src-tauri/src/github/mod.rs`)
- Device Flow auth → GitHub: authenticates with (evidence: `src-tauri/src/github/auth.rs`)
- Updater commands → Update service: checks and installs updates (evidence: `src-tauri/src/commands/updater.rs`)
- Install and reconcile → Coding tools: writes rendered agents (evidence: `README.md`)
