# magiksoft/aider-desk architecture

> Architecture diagram of the GitHub repository magiksoft/aider-desk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/magiksoft/aider-desk
- Repository: https://github.com/magiksoft/aider-desk

## Overview

AiderDesk is a desktop platform for controlled AI-assisted software development. Engineers organize repositories into projects and tasks, steer agent work, review changes and approvals, then use Git workflows to integrate results. Its documented capabilities also include semantic context and memory, multi-model providers, subagents, MCP, extensions, terminal access, analytics, voice, and REST/IDE integrations. The graph combines README-documented relationships with source-index import evidence; unsampled implementation links are omitted or marked dashed rather than asserted as inspected.

Main entry points: [`src/main/agent/agent.ts`](https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/agent.ts) (Agent runtime), [`src/main/task/task.ts`](https://github.com/magiksoft/aider-desk/blob/main/src/main/task/task.ts) (Task runtime), [`src/renderer/src/App.tsx`](https://github.com/magiksoft/aider-desk/blob/main/src/renderer/src/App.tsx) (Desktop UI), [`src/main/task/context-manager.ts`](https://github.com/magiksoft/aider-desk/blob/main/src/main/task/context-manager.ts) (Context engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Workspace experience"]
  node_desktop["Desktop UI<br/>[App.tsx]"]
  node_task_ui["Task workspace<br/>[TasksContext.tsx]"]
end

subgraph group_orchestration["Agent orchestration"]
  node_projects["Projects and tasks<br/>[project-manager.ts]"]
  node_agent["Agent runtime<br/>[agent.ts]"]
  node_task_runtime["Task runtime<br/>[task.ts]"]
  node_profiles["Agent profiles"]
end

subgraph group_context["Context and review"]
  node_context_engine["Context engine<br/>[context-manager.ts]"]
  node_memory["Semantic memory<br/>[memory-manager.ts]"]
  node_repo_map["Repository mapping"]
  node_git["Git and worktrees<br/>[git-manager.ts]"]
  node_approvals["Tool approvals"]
end

subgraph group_platform["Providers and integrations"]
  node_local_data[("Local data<br/>[data-manager.ts]")]
  node_models["Model manager<br/>[model-manager.ts]"]
  node_provider_impl["Provider adapters<br/>[openai.ts]"]
  node_mcp["MCP connections<br/>[mcp-manager.ts]"]
  node_api["REST API<br/>[index.ts]"]
  node_terminal["Integrated terminal<br/>[terminal-api.ts]"]
  node_voice["Voice interactions<br/>[voice-api.ts]"]
  node_analytics["Usage analytics<br/>[usage-api.ts]"]
  node_connector["IDE connectors"]
end

subgraph group_extensions["Extensions"]
  node_extensions["Extension runtime"]
  node_extension_catalog["Extension packages<br/>[runtime.ts]"]
end

node_engineer(("Engineer"))

node_engineer -->|"steers work"| node_desktop
node_desktop -.->|"opens tasks"| node_task_ui
node_task_ui -.->|"manages projects"| node_projects
node_projects -->|"organizes tasks"| node_task_runtime
node_task_runtime -.->|"runs agent"| node_agent
node_agent -.->|"requests inference"| node_models
node_models -->|"loads providers"| node_provider_impl
node_agent -->|"uses profiles"| node_profiles
node_agent -->|"selects context"| node_context_engine
node_context_engine -->|"searches memory"| node_memory
node_context_engine -->|"maps repository"| node_repo_map
node_agent -->|"gates tools"| node_approvals
node_agent -->|"edits worktrees"| node_git
node_task_runtime -->|"persists history"| node_local_data
node_agent -->|"uses MCP"| node_mcp
node_desktop -.->|"integrates through"| node_api
node_extensions -->|"loads extensions"| node_extension_catalog
node_agent -->|"dispatches hooks"| node_extensions
node_task_runtime -->|"runs commands"| node_terminal
node_agent -->|"supports voice"| node_voice
node_task_runtime -->|"tracks usage"| node_analytics
node_connector -->|"syncs context"| node_projects

click node_desktop "https://github.com/magiksoft/aider-desk/blob/main/src/renderer/src/App.tsx"
click node_task_ui "https://github.com/magiksoft/aider-desk/blob/main/src/renderer/src/contexts/TasksContext.tsx"
click node_projects "https://github.com/magiksoft/aider-desk/blob/main/src/main/project/project-manager.ts"
click node_agent "https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/agent.ts"
click node_task_runtime "https://github.com/magiksoft/aider-desk/blob/main/src/main/task/task.ts"
click node_profiles "https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/agent-profile-manager.ts"
click node_context_engine "https://github.com/magiksoft/aider-desk/blob/main/src/main/task/context-manager.ts"
click node_memory "https://github.com/magiksoft/aider-desk/blob/main/src/main/memory/memory-manager.ts"
click node_repo_map "https://github.com/magiksoft/aider-desk/blob/main/packages/tree-sitter-utils/src/repo-map-service.ts"
click node_git "https://github.com/magiksoft/aider-desk/blob/main/src/main/git/git-manager.ts"
click node_approvals "https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/tools/approval-manager.ts"
click node_local_data "https://github.com/magiksoft/aider-desk/blob/main/src/main/data-manager/data-manager.ts"
click node_models "https://github.com/magiksoft/aider-desk/blob/main/src/main/models/model-manager.ts"
click node_provider_impl "https://github.com/magiksoft/aider-desk/blob/main/src/main/models/providers/openai.ts"
click node_mcp "https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/mcp-manager.ts"
click node_api "https://github.com/magiksoft/aider-desk/blob/main/src/main/server/rest-api/index.ts"
click node_extensions "https://github.com/magiksoft/aider-desk/blob/main/src/main/extensions/extension-manager.ts"
click node_extension_catalog "https://github.com/magiksoft/aider-desk/blob/main/packages/extensions/src/runtime.ts"
click node_terminal "https://github.com/magiksoft/aider-desk/blob/main/src/main/server/rest-api/terminal-api.ts"
click node_voice "https://github.com/magiksoft/aider-desk/blob/main/src/main/server/rest-api/voice-api.ts"
click node_analytics "https://github.com/magiksoft/aider-desk/blob/main/src/main/server/rest-api/usage-api.ts"
click node_connector "https://github.com/magiksoft/aider-desk/blob/main/src/main/connector/connector-manager.ts"

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_desktop,node_task_ui toneBlue
class node_projects,node_agent,node_task_runtime,node_profiles toneAmber
class node_context_engine,node_memory,node_repo_map,node_git,node_approvals toneMint
class node_local_data,node_models,node_provider_impl,node_mcp,node_api,node_terminal,node_voice,node_analytics,node_connector toneRose
class node_extensions,node_extension_catalog,node_engineer toneIndigo
```

## Components

### Workspace experience

- [Desktop UI](https://github.com/magiksoft/aider-desk/blob/main/src/renderer/src/App.tsx): `src/renderer/src/App.tsx`
- [Task workspace](https://github.com/magiksoft/aider-desk/blob/main/src/renderer/src/contexts/TasksContext.tsx): `src/renderer/src/contexts/TasksContext.tsx`

### Agent orchestration

- [Projects and tasks](https://github.com/magiksoft/aider-desk/blob/main/src/main/project/project-manager.ts): `src/main/project/project-manager.ts`
- [Agent runtime](https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/agent.ts): `src/main/agent/agent.ts`
- [Task runtime](https://github.com/magiksoft/aider-desk/blob/main/src/main/task/task.ts): `src/main/task/task.ts`
- [Agent profiles](https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/agent-profile-manager.ts): `src/main/agent/agent-profile-manager.ts`

### Context and review

- [Context engine](https://github.com/magiksoft/aider-desk/blob/main/src/main/task/context-manager.ts): `src/main/task/context-manager.ts`
- [Semantic memory](https://github.com/magiksoft/aider-desk/blob/main/src/main/memory/memory-manager.ts): `src/main/memory/memory-manager.ts`
- [Repository mapping](https://github.com/magiksoft/aider-desk/blob/main/packages/tree-sitter-utils/src/repo-map-service.ts): `packages/tree-sitter-utils/src/repo-map-service.ts`
- [Git and worktrees](https://github.com/magiksoft/aider-desk/blob/main/src/main/git/git-manager.ts): `src/main/git/git-manager.ts`
- [Tool approvals](https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/tools/approval-manager.ts): `src/main/agent/tools/approval-manager.ts`

### Providers and integrations

- [Local data](https://github.com/magiksoft/aider-desk/blob/main/src/main/data-manager/data-manager.ts): `src/main/data-manager/data-manager.ts`
- [Model manager](https://github.com/magiksoft/aider-desk/blob/main/src/main/models/model-manager.ts): `src/main/models/model-manager.ts`
- [Provider adapters](https://github.com/magiksoft/aider-desk/blob/main/src/main/models/providers/openai.ts): `src/main/models/providers/openai.ts`
- [MCP connections](https://github.com/magiksoft/aider-desk/blob/main/src/main/agent/mcp-manager.ts): `src/main/agent/mcp-manager.ts`
- [REST API](https://github.com/magiksoft/aider-desk/blob/main/src/main/server/rest-api/index.ts): `src/main/server/rest-api/index.ts`
- [Integrated terminal](https://github.com/magiksoft/aider-desk/blob/main/src/main/server/rest-api/terminal-api.ts): `src/main/server/rest-api/terminal-api.ts`
- [Voice interactions](https://github.com/magiksoft/aider-desk/blob/main/src/main/server/rest-api/voice-api.ts): `src/main/server/rest-api/voice-api.ts`
- [Usage analytics](https://github.com/magiksoft/aider-desk/blob/main/src/main/server/rest-api/usage-api.ts): `src/main/server/rest-api/usage-api.ts`
- [IDE connectors](https://github.com/magiksoft/aider-desk/blob/main/src/main/connector/connector-manager.ts): `src/main/connector/connector-manager.ts`

### Extensions

- [Extension runtime](https://github.com/magiksoft/aider-desk/blob/main/src/main/extensions/extension-manager.ts): `src/main/extensions/extension-manager.ts`
- [Extension packages](https://github.com/magiksoft/aider-desk/blob/main/packages/extensions/src/runtime.ts): `packages/extensions/src/runtime.ts`

### Other components

- **Engineer**

## Connections

- Engineer → Desktop UI: steers work
- Desktop UI → Task workspace: opens tasks
- Task workspace → Projects and tasks: manages projects
- Projects and tasks → Task runtime: organizes tasks
- Task runtime → Agent runtime: runs agent
- Agent runtime → Model manager: requests inference
- Model manager → Provider adapters: loads providers (evidence: `src/main/models/model-manager.ts`)
- Agent runtime → Agent profiles: uses profiles
- Agent runtime → Context engine: selects context
- Context engine → Semantic memory: searches memory
- Context engine → Repository mapping: maps repository
- Agent runtime → Tool approvals: gates tools
- Agent runtime → Git and worktrees: edits worktrees
- Task runtime → Local data: persists history
- Agent runtime → MCP connections: uses MCP
- Desktop UI → REST API: integrates through
- Extension runtime → Extension packages: loads extensions (evidence: `src/main/extensions/extension-manager.ts`)
- Agent runtime → Extension runtime: dispatches hooks
- Task runtime → Integrated terminal: runs commands
- Agent runtime → Voice interactions: supports voice
- Task runtime → Usage analytics: tracks usage
- IDE connectors → Projects and tasks: syncs context
