# xoshbin/asyar architecture

> Architecture diagram of the GitHub repository xoshbin/asyar, 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/xoshbin/asyar
- Repository: https://github.com/xoshbin/asyar

## Overview

Asyar is a cross-platform, privacy-focused desktop launcher: a user summons the native app, searches or invokes a capability, and receives a result or action. The graph captures the launcher/search route and major documented feature branches, with Rust domain services and extension isolation as internal layers. Several feature implementations are unsampled, so their README-documented capabilities are shown without asserting unverified internal call paths.

Main entry points: [`asyar-launcher/src/lib/launcher/launcherController.svelte.ts`](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/lib/launcher/launcherController.svelte.ts) (Launcher controller), [`asyar-launcher/src/services/search/SearchService.ts`](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/search/SearchService.ts) (Search service), [`asyar-launcher/src/lib/ipc/extensionStorageCommands.ts`](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/lib/ipc/extensionStorageCommands.ts) (Extension storage IPC), [`asyar-launcher/src-tauri/src/bootstrap/storage.rs`](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/bootstrap/storage.rs) (SQLite data store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Launcher experience"]
  node_launcher["Launcher controller"]
  node_search["Search service<br/>[SearchService.ts]"]
end

subgraph group_features["Product capabilities"]
  node_calculator["Calculator engine<br/>[engine.rs]"]
  node_agents["AI agents<br/>[runner.rs]"]
  node_clipboard["Clipboard history"]
  node_browser["Browser integration<br/>[service.rs]"]
  node_mcp["MCP servers<br/>[server.rs]"]
  node_window["Window management"]
  node_snippets[("Snippets and scripts")]
end

subgraph group_runtime["Native runtime"]
  node_fileindex["File index query<br/>[query.rs]"]
  node_kvcommands["Extension storage IPC"]
  node_datastore[("SQLite data store<br/>[storage.rs]")]
  node_filecommands["File commands<br/>[files.rs]"]
end

subgraph group_extensions["Extension platform"]
  node_extensions["Extension manager"]
  node_iframe["Extension iframe"]
  node_ipc["Extension IPC pipeline<br/>[pipeline.ts]"]
  node_worker["Extension worker SDK<br/>[worker.ts]"]
  node_storageproxy["Storage proxy"]
end

node_user(("User"))

node_user -->|"summons"| node_launcher
node_launcher -->|"queries"| node_search
node_search -.->|"searches files"| node_fileindex
node_user -.->|"calculates"| node_calculator
node_user -.->|"runs agents"| node_agents
node_user -.->|"browses history"| node_clipboard
node_user -.->|"uses browser data"| node_browser
node_user -.->|"uses MCP tools"| node_mcp
node_user -.->|"manages windows"| node_window
node_user -.->|"uses snippets"| node_snippets
node_launcher -->|"dispatches commands"| node_extensions
node_extensions -->|"manages views"| node_iframe
node_iframe -->|"routes messages"| node_ipc
node_worker -->|"provides storage"| node_storageproxy
node_storageproxy -.->|"invokes storage"| node_kvcommands
node_kvcommands -.->|"persists values"| node_datastore
node_datastore -.->|"serves file data"| node_filecommands

click node_launcher "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/lib/launcher/launcherController.svelte.ts"
click node_search "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/search/SearchService.ts"
click node_fileindex "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/file_index/query.rs"
click node_calculator "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/crates/asyar-calculator/src/engine.rs"
click node_agents "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/agents/runner.rs"
click node_clipboard "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/clipboard/clipboardHistoryService.ts"
click node_browser "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/browser/service.rs"
click node_mcp "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/mcp/server.rs"
click node_extensions "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/extension/extensionManager.svelte.ts"
click node_iframe "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/extension/extensionIframeManager.svelte.ts"
click node_ipc "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/extension/ipc/pipeline.ts"
click node_worker "https://github.com/xoshbin/asyar/blob/main/asyar-sdk/src/worker.ts"
click node_storageproxy "https://github.com/xoshbin/asyar/blob/main/asyar-sdk/src/services/StorageServiceProxy.ts"
click node_kvcommands "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/lib/ipc/extensionStorageCommands.ts"
click node_datastore "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/bootstrap/storage.rs"
click node_filecommands "https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/commands/files.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_launcher,node_search,node_user toneBlue
class node_calculator,node_agents,node_clipboard,node_browser,node_mcp,node_window,node_snippets toneAmber
class node_fileindex,node_kvcommands,node_datastore,node_filecommands toneMint
class node_extensions,node_iframe,node_ipc,node_worker,node_storageproxy toneRose
```

## Components

### Launcher experience

- [Launcher controller](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/lib/launcher/launcherController.svelte.ts): `asyar-launcher/src/lib/launcher/launcherController.svelte.ts`
- [Search service](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/search/SearchService.ts): `asyar-launcher/src/services/search/SearchService.ts`

### Product capabilities

- [Calculator engine](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/crates/asyar-calculator/src/engine.rs): `asyar-launcher/src-tauri/crates/asyar-calculator/src/engine.rs`
- [AI agents](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/agents/runner.rs): `asyar-launcher/src-tauri/src/agents/runner.rs`
- [Clipboard history](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/clipboard/clipboardHistoryService.ts): `asyar-launcher/src/services/clipboard/clipboardHistoryService.ts`
- [Browser integration](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/browser/service.rs): `asyar-launcher/src-tauri/src/browser/service.rs`
- [MCP servers](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/mcp/server.rs): `asyar-launcher/src-tauri/src/mcp/server.rs`
- **Window management**
- **Snippets and scripts**

### Native runtime

- [File index query](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/file_index/query.rs): `asyar-launcher/src-tauri/src/file_index/query.rs`
- [Extension storage IPC](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/lib/ipc/extensionStorageCommands.ts): `asyar-launcher/src/lib/ipc/extensionStorageCommands.ts`
- [SQLite data store](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/bootstrap/storage.rs): `asyar-launcher/src-tauri/src/bootstrap/storage.rs`
- [File commands](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src-tauri/src/commands/files.rs): `asyar-launcher/src-tauri/src/commands/files.rs`

### Extension platform

- [Extension manager](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/extension/extensionManager.svelte.ts): `asyar-launcher/src/services/extension/extensionManager.svelte.ts`
- [Extension iframe](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/extension/extensionIframeManager.svelte.ts): `asyar-launcher/src/services/extension/extensionIframeManager.svelte.ts`
- [Extension IPC pipeline](https://github.com/xoshbin/asyar/blob/main/asyar-launcher/src/services/extension/ipc/pipeline.ts): `asyar-launcher/src/services/extension/ipc/pipeline.ts`
- [Extension worker SDK](https://github.com/xoshbin/asyar/blob/main/asyar-sdk/src/worker.ts): `asyar-sdk/src/worker.ts`
- [Storage proxy](https://github.com/xoshbin/asyar/blob/main/asyar-sdk/src/services/StorageServiceProxy.ts): `asyar-sdk/src/services/StorageServiceProxy.ts`

### Other components

- **User**

## Connections

- User → Launcher controller: summons
- Launcher controller → Search service: queries (evidence: `asyar-launcher/src/lib/launcher/launcherController.svelte.ts`)
- Search service → File index query: searches files
- User → Calculator engine: calculates
- User → AI agents: runs agents
- User → Clipboard history: browses history
- User → Browser integration: uses browser data
- User → MCP servers: uses MCP tools
- User → Window management: manages windows
- User → Snippets and scripts: uses snippets
- Launcher controller → Extension manager: dispatches commands (evidence: `asyar-launcher/src/lib/launcher/launcherController.svelte.ts`)
- Extension manager → Extension iframe: manages views (evidence: `asyar-launcher/src/services/extension/extensionManager.svelte.ts`)
- Extension iframe → Extension IPC pipeline: routes messages (evidence: `asyar-launcher/src/services/extension/ipc/pipeline.ts`)
- Extension worker SDK → Storage proxy: provides storage (evidence: `asyar-sdk/src/worker.ts`)
- Storage proxy → Extension storage IPC: invokes storage
- Extension storage IPC → SQLite data store: persists values
- SQLite data store → File commands: serves file data
