# thiagodebona-ui/devdeck architecture

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

## Overview

DevDeck is a local-first desktop developer command deck. Users save scripts, select a workspace, run a command, and watch its output; chains and file watches extend that workflow. The app also provides separate AI, HTTP, system-inspection, clipboard, screenshot, and text-tool capabilities. The graph combines README-documented features with relationships visible in the supplied excerpts and source index; unsampled feature internals are represented by their exact enclosing directories, without asserting unverified calls.

Main entry points: [`src/DevDeck.App/ViewModels/CommandItem.cs`](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/CommandItem.cs) (Command deck), [`src/DevDeck.App/App.axaml.cs`](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/App.axaml.cs) (Desktop shell), [`src/DevDeck.App/ViewModels/AutomationViewModel.cs`](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/AutomationViewModel.cs) (Chains and watches), [`src/DevDeck.App/ViewModels/AssistantViewModel.cs`](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/AssistantViewModel.cs) (AI assistant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_desktop["Desktop shell<br/>[App.axaml.cs]"]
  node_mainvm["Main navigation"]
  node_theme["Theme manager<br/>[ThemeManager.cs]"]
end

subgraph group_commands["Command workflows"]
  node_deck["Command deck<br/>[CommandItem.cs]"]
  node_script["Script preparation<br/>[ScriptFile.cs]"]
  node_process["Process execution<br/>[ProcessRunner.cs]"]
  node_automation["Chains and watches"]
  node_chain["Chain definitions<br/>[CommandChain.cs]"]
end

subgraph group_integrations["Developer tools"]
  node_assistant["AI assistant"]
  node_ai["AI providers<br/>[AiClient.cs]"]
  node_httpui["HTTP client UI<br/>[HttpViewModel.cs]"]
  node_http["HTTP requests<br/>[HttpCall.cs]"]
  node_running["Ports and containers"]
  node_toolbox["Text toolbox<br/>[TextTools.cs]"]
  node_clipboard[("Clipboard history<br/>[Clips.cs]")]
  node_screenshots["Screenshot gallery<br/>[Shots.cs]"]
end

subgraph group_platform["Platform services"]
  node_settings[("Preferences store<br/>[AppSettings.cs]")]
  node_monitor["Resource monitor<br/>[MemoryStatus.cs]"]
  node_cleanup["Memory cleanup<br/>[MemoryClean.cs]"]
  node_log[("Session log<br/>[AppLog.cs]")]
end

node_user(("Developer"))

node_user -->|"opens and uses"| node_desktop
node_desktop -->|"loads preferences"| node_settings
node_desktop -->|"applies theme"| node_theme
node_desktop -->|"creates window model"| node_mainvm
node_mainvm -.->|"shows commands"| node_deck
node_user -->|"runs saved command"| node_deck
node_deck -->|"prepares script"| node_script
node_deck -->|"starts process"| node_process
node_deck -.->|"saves commands"| node_settings
node_user -->|"configures automation"| node_automation
node_automation -->|"uses chain definitions"| node_chain
node_automation -.->|"runs commands"| node_deck
node_user -->|"requests help"| node_assistant
node_assistant -->|"sends model requests"| node_ai
node_assistant -->|"creates commands"| node_deck
node_user -->|"sends API request"| node_httpui
node_httpui -.->|"sends request"| node_http
node_user -->|"inspects system"| node_running
node_user -->|"uses text tools"| node_toolbox
node_user -->|"searches copied items"| node_clipboard
node_user -->|"reviews captures"| node_screenshots
node_user -->|"views resource usage"| node_monitor
node_user -->|"cleans memory"| node_cleanup
node_user -->|"reviews session activity"| node_log
node_user -->|"changes preferences"| node_settings

click node_desktop "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/App.axaml.cs"
click node_mainvm "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/MainWindowViewModel.cs"
click node_settings "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Settings/AppSettings.cs"
click node_deck "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/CommandItem.cs"
click node_script "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Commands/ScriptFile.cs"
click node_process "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Commands/ProcessRunner.cs"
click node_automation "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/AutomationViewModel.cs"
click node_chain "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Commands/CommandChain.cs"
click node_assistant "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/AssistantViewModel.cs"
click node_ai "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Ai/AiClient.cs"
click node_httpui "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/HttpViewModel.cs"
click node_http "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Tools/HttpCall.cs"
click node_running "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/RunningViewModel.cs"
click node_toolbox "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Tools/TextTools.cs"
click node_clipboard "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Tools/Clips.cs"
click node_screenshots "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Tools/Shots.cs"
click node_monitor "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Platform/MemoryStatus.cs"
click node_cleanup "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Platform/MemoryClean.cs"
click node_log "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Commands/AppLog.cs"
click node_theme "https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ThemeManager.cs"

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_mainvm,node_theme toneBlue
class node_deck,node_script,node_process,node_automation,node_chain toneAmber
class node_assistant,node_ai,node_httpui,node_http,node_running,node_toolbox,node_clipboard,node_screenshots toneMint
class node_settings,node_monitor,node_cleanup,node_log toneRose
class node_user toneIndigo
```

## Components

### Desktop app

- [Desktop shell](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/App.axaml.cs): `src/DevDeck.App/App.axaml.cs`
- [Main navigation](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/MainWindowViewModel.cs): `src/DevDeck.App/ViewModels/MainWindowViewModel.cs`
- [Theme manager](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ThemeManager.cs): `src/DevDeck.App/ThemeManager.cs`

### Command workflows

- [Command deck](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/CommandItem.cs): `src/DevDeck.App/ViewModels/CommandItem.cs`
- [Script preparation](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Commands/ScriptFile.cs): `src/DevDeck.Core/Commands/ScriptFile.cs`
- [Process execution](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Commands/ProcessRunner.cs): `src/DevDeck.Core/Commands/ProcessRunner.cs`
- [Chains and watches](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/AutomationViewModel.cs): `src/DevDeck.App/ViewModels/AutomationViewModel.cs`
- [Chain definitions](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Commands/CommandChain.cs): `src/DevDeck.Core/Commands/CommandChain.cs`

### Developer tools

- [AI assistant](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/AssistantViewModel.cs): `src/DevDeck.App/ViewModels/AssistantViewModel.cs`
- [AI providers](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Ai/AiClient.cs): `src/DevDeck.Core/Ai/AiClient.cs`
- [HTTP client UI](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/HttpViewModel.cs): `src/DevDeck.App/ViewModels/HttpViewModel.cs`
- [HTTP requests](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Tools/HttpCall.cs): `src/DevDeck.Core/Tools/HttpCall.cs`
- [Ports and containers](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.App/ViewModels/RunningViewModel.cs): `src/DevDeck.App/ViewModels/RunningViewModel.cs`
- [Text toolbox](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Tools/TextTools.cs): `src/DevDeck.Core/Tools/TextTools.cs`
- [Clipboard history](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Tools/Clips.cs): `src/DevDeck.Core/Tools/Clips.cs`
- [Screenshot gallery](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Tools/Shots.cs): `src/DevDeck.Core/Tools/Shots.cs`

### Platform services

- [Preferences store](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Settings/AppSettings.cs): `src/DevDeck.Core/Settings/AppSettings.cs`
- [Resource monitor](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Platform/MemoryStatus.cs): `src/DevDeck.Core/Platform/MemoryStatus.cs`
- [Memory cleanup](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Platform/MemoryClean.cs): `src/DevDeck.Core/Platform/MemoryClean.cs`
- [Session log](https://github.com/thiagodebona-ui/devdeck/blob/main/src/DevDeck.Core/Commands/AppLog.cs): `src/DevDeck.Core/Commands/AppLog.cs`

### Other components

- **Developer**

## Connections

- Developer → Desktop shell: opens and uses (evidence: `README.md`)
- Desktop shell → Preferences store: loads preferences (evidence: `src/DevDeck.App/App.axaml.cs`)
- Desktop shell → Theme manager: applies theme (evidence: `src/DevDeck.App/App.axaml.cs`)
- Desktop shell → Main navigation: creates window model (evidence: `src/DevDeck.App/App.axaml.cs`)
- Main navigation → Command deck: shows commands
- Developer → Command deck: runs saved command (evidence: `README.md`)
- Command deck → Script preparation: prepares script (evidence: `src/DevDeck.App/ViewModels/CommandItem.cs`)
- Command deck → Process execution: starts process (evidence: `src/DevDeck.App/ViewModels/CommandItem.cs`)
- Command deck → Preferences store: saves commands
- Developer → Chains and watches: configures automation (evidence: `README.md`)
- Chains and watches → Chain definitions: uses chain definitions (evidence: `src/DevDeck.App/ViewModels/AutomationViewModel.cs`)
- Chains and watches → Command deck: runs commands (evidence: `src/DevDeck.App/ViewModels/AutomationViewModel.cs`)
- Developer → AI assistant: requests help (evidence: `README.md`)
- AI assistant → AI providers: sends model requests (evidence: `src/DevDeck.App/ViewModels/AssistantViewModel.cs`)
- AI assistant → Command deck: creates commands (evidence: `src/DevDeck.App/ViewModels/AssistantViewModel.cs`)
- Developer → HTTP client UI: sends API request (evidence: `README.md`)
- HTTP client UI → HTTP requests: sends request
- Developer → Ports and containers: inspects system (evidence: `README.md`)
- Developer → Text toolbox: uses text tools (evidence: `README.md`)
- Developer → Clipboard history: searches copied items (evidence: `README.md`)
- Developer → Screenshot gallery: reviews captures (evidence: `README.md`)
- Developer → Resource monitor: views resource usage (evidence: `README.md`)
- Developer → Memory cleanup: cleans memory (evidence: `README.md`)
- Developer → Session log: reviews session activity (evidence: `README.md`)
- Developer → Preferences store: changes preferences (evidence: `README.md`)
