# tommasinigiovanni/claude-code-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/tommasinigiovanni/claude-code-dashboard
- Repository: https://github.com/tommasinigiovanni/claude-code-dashboard

## Overview

Claude Code Dashboard is a Tauri desktop GUI for launching Claude Code and managing its configuration. Users enter through the React app, choose a dashboard page or launcher workflow, and the frontend loads or updates settings through Tauri commands; local or SSH-backed access is supported in the configuration store. Chat and embedded-terminal modes, Telegram control, and management pages for MCP, skills, agents, hooks, profiles, usage, logs, health, learning, and verification are documented capabilities. Backend command wiring is visible in `lib.rs`; most backend implementations were not sampled, so their internal calls are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/App.tsx) (App shell), [`src-tauri/src/lib.rs`](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/lib.rs) (Tauri command registry), [`src/store/configStore.ts`](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/store/configStore.ts) (Configuration state), [`src/pages/LauncherPage.tsx`](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/LauncherPage.tsx) (Launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Desktop interface"]
  node_app["App shell<br/>[App.tsx]"]
end

subgraph group_management["Configuration management"]
  node_mcp["MCP manager<br/>[McpPage.tsx]"]
  node_skills["Skills and plugins<br/>[SkillsPage.tsx]"]
  node_agents["Sub-agents<br/>[SubagentsPage.tsx]"]
  node_hooks["Hooks<br/>[HooksPage.tsx]"]
  node_settings["Settings<br/>[SettingsPage.tsx]"]
  node_profiles["Profiles<br/>[ProfilesPage.tsx]"]
  node_importexport["Import and export"]
  node_extras["Operational pages"]
end

subgraph group_runtime["Launch and control"]
  node_launcher["Launcher<br/>[LauncherPage.tsx]"]
  node_chat["Chat mode<br/>[ChatView.tsx]"]
  node_terminal["Embedded terminal"]
end

subgraph group_backend["Tauri services"]
  node_tauri["Tauri command registry<br/>[lib.rs]"]
  node_readers["Config readers<br/>[readers.rs]"]
  node_backendconfig["Config operations<br/>[config.rs]"]
  node_chatservice["Chat service<br/>[chat.rs]"]
  node_terminalservice["Terminal service<br/>[terminal.rs]"]
  node_sshservice["SSH services<br/>[ssh.rs]"]
  node_telegram["Telegram bot<br/>[telegram.rs]"]
  node_launcherbackend["Launch services<br/>[launcher.rs]"]
  node_backendextras["Other Tauri services"]
end

subgraph group_shared["Shared frontend state"]
  node_configstore["Configuration state<br/>[configStore.ts]"]
  node_uistore["UI state<br/>[uiStore.ts]"]
  node_sshconfig["SSH settings<br/>[useSshConfig.ts]"]
  node_types["Claude data types<br/>[claude.ts]"]
  node_uiprimitives["UI primitives"]
  node_translations["Translations<br/>[translations.ts]"]
end

node_user(("Desktop user"))
node_claude(("Claude Code"))
node_telegramuser(("Telegram user"))
node_telegramservice(("Telegram"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_launcher
node_app -->|"routes to"| node_mcp
node_app -->|"routes to"| node_skills
node_app -->|"routes to"| node_agents
node_app -->|"routes to"| node_hooks
node_app -->|"routes to"| node_settings
node_app -->|"routes to"| node_profiles
node_app -->|"routes to"| node_extras
node_app -->|"reads page state"| node_uistore
node_app -->|"loads configuration"| node_configstore
node_app -->|"invokes backup and bot commands"| node_tauri
node_launcher -->|"renders"| node_chat
node_launcher -->|"renders"| node_terminal
node_launcher -.->|"launches"| node_claude
node_configstore -->|"invokes config commands"| node_tauri
node_configstore -->|"checks remote settings"| node_sshconfig
node_configstore -->|"uses data types"| node_types
node_configstore -->|"loads dashboard data"| node_readers
node_configstore -->|"writes configuration"| node_backendconfig
node_tauri -->|"registers commands"| node_readers
node_tauri -->|"registers commands"| node_backendconfig
node_tauri -->|"registers commands"| node_chatservice
node_tauri -->|"registers commands"| node_terminalservice
node_tauri -->|"registers commands"| node_sshservice
node_tauri -->|"registers commands"| node_telegram
node_tauri -->|"registers commands"| node_launcherbackend
node_tauri -->|"registers commands"| node_backendextras
node_telegramuser -.->|"sends bot messages"| node_telegramservice
node_telegram -->|"uses launch services"| node_launcherbackend
node_chat -.->|"invokes chat commands"| node_chatservice
node_terminal -.->|"invokes terminal commands"| node_terminalservice
node_telegram -.->|"communicates with"| node_telegramservice
node_mcp -.->|"manages settings"| node_configstore
node_skills -.->|"reads configuration"| node_configstore
node_agents -->|"manages agents"| node_configstore
node_settings -->|"includes"| node_importexport
node_settings -->|"invokes backup commands"| node_tauri
node_app -->|"uses localization"| node_translations
node_mcp -.->|"uses controls"| node_uiprimitives
node_agents -->|"uses controls"| node_uiprimitives

click node_app "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/App.tsx"
click node_launcher "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/LauncherPage.tsx"
click node_chat "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/components/chat/ChatView.tsx"
click node_terminal "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/components/terminal/EmbeddedTerminal.tsx"
click node_mcp "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/McpPage.tsx"
click node_skills "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/SkillsPage.tsx"
click node_agents "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/SubagentsPage.tsx"
click node_hooks "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/HooksPage.tsx"
click node_settings "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/SettingsPage.tsx"
click node_profiles "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/ProfilesPage.tsx"
click node_importexport "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/ImportExportPage.tsx"
click node_extras "https://github.com/tommasinigiovanni/claude-code-dashboard/tree/main/src/pages"
click node_configstore "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/store/configStore.ts"
click node_uistore "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/store/uiStore.ts"
click node_sshconfig "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/hooks/useSshConfig.ts"
click node_types "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/types/claude.ts"
click node_tauri "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/lib.rs"
click node_readers "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/readers.rs"
click node_backendconfig "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/config.rs"
click node_chatservice "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/chat.rs"
click node_terminalservice "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/terminal.rs"
click node_sshservice "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/ssh.rs"
click node_telegram "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/telegram.rs"
click node_launcherbackend "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/launcher.rs"
click node_backendextras "https://github.com/tommasinigiovanni/claude-code-dashboard/tree/main/src-tauri/src"
click node_uiprimitives "https://github.com/tommasinigiovanni/claude-code-dashboard/tree/main/src/components/ui"
click node_translations "https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/i18n/translations.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_app,node_user,node_telegramuser toneBlue
class node_mcp,node_skills,node_agents,node_hooks,node_settings,node_profiles,node_importexport,node_extras toneAmber
class node_launcher,node_chat,node_terminal toneMint
class node_tauri,node_readers,node_backendconfig,node_chatservice,node_terminalservice,node_sshservice,node_telegram,node_launcherbackend,node_backendextras toneRose
class node_configstore,node_uistore,node_sshconfig,node_types,node_uiprimitives,node_translations,node_claude,node_telegramservice toneIndigo
```

## Components

### Desktop interface

- [App shell](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/App.tsx): `src/App.tsx`

### Configuration management

- [MCP manager](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/McpPage.tsx): `src/pages/McpPage.tsx`
- [Skills and plugins](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/SkillsPage.tsx): `src/pages/SkillsPage.tsx`
- [Sub-agents](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/SubagentsPage.tsx): `src/pages/SubagentsPage.tsx`
- [Hooks](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/HooksPage.tsx): `src/pages/HooksPage.tsx`
- [Settings](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/SettingsPage.tsx): `src/pages/SettingsPage.tsx`
- [Profiles](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/ProfilesPage.tsx): `src/pages/ProfilesPage.tsx`
- [Import and export](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/ImportExportPage.tsx): `src/pages/ImportExportPage.tsx`
- [Operational pages](https://github.com/tommasinigiovanni/claude-code-dashboard/tree/main/src/pages): `src/pages`

### Launch and control

- [Launcher](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/pages/LauncherPage.tsx): `src/pages/LauncherPage.tsx`
- [Chat mode](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/components/chat/ChatView.tsx): `src/components/chat/ChatView.tsx`
- [Embedded terminal](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/components/terminal/EmbeddedTerminal.tsx): `src/components/terminal/EmbeddedTerminal.tsx`

### Tauri services

- [Tauri command registry](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Config readers](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/readers.rs): `src-tauri/src/readers.rs`
- [Config operations](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/config.rs): `src-tauri/src/config.rs`
- [Chat service](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/chat.rs): `src-tauri/src/chat.rs`
- [Terminal service](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/terminal.rs): `src-tauri/src/terminal.rs`
- [SSH services](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/ssh.rs): `src-tauri/src/ssh.rs`
- [Telegram bot](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/telegram.rs): `src-tauri/src/telegram.rs`
- [Launch services](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src-tauri/src/launcher.rs): `src-tauri/src/launcher.rs`
- [Other Tauri services](https://github.com/tommasinigiovanni/claude-code-dashboard/tree/main/src-tauri/src): `src-tauri/src`

### Shared frontend state

- [Configuration state](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/store/configStore.ts): `src/store/configStore.ts`
- [UI state](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/store/uiStore.ts): `src/store/uiStore.ts`
- [SSH settings](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/hooks/useSshConfig.ts): `src/hooks/useSshConfig.ts`
- [Claude data types](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/types/claude.ts): `src/types/claude.ts`
- [UI primitives](https://github.com/tommasinigiovanni/claude-code-dashboard/tree/main/src/components/ui): `src/components/ui`
- [Translations](https://github.com/tommasinigiovanni/claude-code-dashboard/blob/main/src/i18n/translations.ts): `src/i18n/translations.ts`

### Other components

- **Desktop user**
- **Claude Code**
- **Telegram user**
- **Telegram**

## Connections

- Desktop user → App shell: uses (evidence: `README.md`)
- App shell → Launcher: routes to (evidence: `src/App.tsx`)
- App shell → MCP manager: routes to (evidence: `src/App.tsx`)
- App shell → Skills and plugins: routes to (evidence: `src/App.tsx`)
- App shell → Sub-agents: routes to (evidence: `src/App.tsx`)
- App shell → Hooks: routes to (evidence: `src/App.tsx`)
- App shell → Settings: routes to (evidence: `src/App.tsx`)
- App shell → Profiles: routes to (evidence: `src/App.tsx`)
- App shell → Operational pages: routes to (evidence: `src/App.tsx`)
- App shell → UI state: reads page state (evidence: `src/App.tsx`)
- App shell → Configuration state: loads configuration (evidence: `src/App.tsx`)
- App shell → Tauri command registry: invokes backup and bot commands (evidence: `src/App.tsx`)
- Launcher → Chat mode: renders (evidence: `src/pages/LauncherPage.tsx`)
- Launcher → Embedded terminal: renders (evidence: `src/pages/LauncherPage.tsx`)
- Launcher → Claude Code: launches (evidence: `README.md`)
- Configuration state → Tauri command registry: invokes config commands (evidence: `src/store/configStore.ts`)
- Configuration state → SSH settings: checks remote settings (evidence: `src/store/configStore.ts`)
- Configuration state → Claude data types: uses data types (evidence: `src/store/configStore.ts`)
- Configuration state → Config readers: loads dashboard data (evidence: `src/store/configStore.ts`)
- Configuration state → Config operations: writes configuration (evidence: `src/store/configStore.ts`)
- Tauri command registry → Config readers: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command registry → Config operations: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command registry → Chat service: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command registry → Terminal service: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command registry → SSH services: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command registry → Telegram bot: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command registry → Launch services: registers commands (evidence: `src-tauri/src/lib.rs`)
- Tauri command registry → Other Tauri services: registers commands (evidence: `src-tauri/src/lib.rs`)
- Telegram user → Telegram: sends bot messages (evidence: `README.md`)
- Telegram bot → Launch services: uses launch services (evidence: `src-tauri/src/telegram.rs`)
- Chat mode → Chat service: invokes chat commands
- Embedded terminal → Terminal service: invokes terminal commands
- Telegram bot → Telegram: communicates with (evidence: `README.md`)
- MCP manager → Configuration state: manages settings
- Skills and plugins → Configuration state: reads configuration
- Sub-agents → Configuration state: manages agents (evidence: `src/pages/SubagentsPage.tsx`)
- Settings → Import and export: includes (evidence: `src/pages/SettingsPage.tsx`)
- Settings → Tauri command registry: invokes backup commands (evidence: `src/pages/SettingsPage.tsx`)
- App shell → Translations: uses localization (evidence: `src/App.tsx`)
- MCP manager → UI primitives: uses controls
- Sub-agents → UI primitives: uses controls (evidence: `src/pages/SubagentsPage.tsx`)
