How magiksoft/aider-desk works
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: agent.ts Agent runtime · task.ts Task runtime · App.tsx Desktop UI · context-manager.ts Context engine
Components 23
Workspace experience
- Desktop UI
src/renderer/src/App.tsx - Task workspace
src/renderer/src/contexts/TasksContext.tsx
Agent orchestration
- Projects and tasks
src/main/project/project-manager.ts - Agent runtime
src/main/agent/agent.ts - Task runtime
src/main/task/task.ts - Agent profiles
src/main/agent/agent-profile-manager.ts
Context and review
- Context engine
src/main/task/context-manager.ts - Semantic memory
src/main/memory/memory-manager.ts - Repository mapping
packages/tree-sitter-utils/src/repo-map-service.ts - Git and worktrees
src/main/git/git-manager.ts - Tool approvals
src/main/agent/tools/approval-manager.ts
Providers and integrations
- Local data
src/main/data-manager/data-manager.ts - Model manager
src/main/models/model-manager.ts - Provider adapters
src/main/models/providers/openai.ts - MCP connections
src/main/agent/mcp-manager.ts - REST API
src/main/server/rest-api/index.ts - Integrated terminal
src/main/server/rest-api/terminal-api.ts - Voice interactions
src/main/server/rest-api/voice-api.ts - Usage analytics
src/main/server/rest-api/usage-api.ts - IDE connectors
src/main/connector/connector-manager.ts
Extensions
- Extension runtime
src/main/extensions/extension-manager.ts - Extension packages
packages/extensions/src/runtime.ts
Other components
- Engineer
Connections 22
- 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
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
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