# chethanbhatbs/my-claude architecture

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

## Overview

My Claude is a local dashboard for Claude Code data. A user opens the dashboard, which reads local conversations and configuration and presents overview, usage, history, skills, integrations, and system information. It also manages selected settings and supports exports, alerts, and optional GitHub or Anthropic API interactions. The sampled source is a single large FastAPI module; the README documents capabilities whose individual handlers were not sampled, so those links are documented rather than inferred from sibling modules.

Main entry points: [`app/myclaude.py`](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py) (Dashboard server), [`app/templates/overview.html`](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/overview.html) (Overview), [`app/templates/token.html`](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/token.html) (Usage page), [`app/templates/history.html`](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/history.html) (History page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Dashboard runtime"]
  node_server["Dashboard server<br/>[myclaude.py]"]
  node_overview["Overview<br/>[overview.html]"]
end

subgraph group_insights["Activity insights"]
  node_usage["Usage analytics<br/>[myclaude.py]"]
  node_usage_view["Usage page<br/>[token.html]"]
  node_history["Conversation history<br/>[myclaude.py]"]
  node_history_view["History page<br/>[history.html]"]
end

subgraph group_management["Configuration management"]
  node_skills["Skills browser<br/>[myclaude.py]"]
  node_skills_view["Skills page<br/>[skills.html]"]
  node_connectors["MCP servers<br/>[myclaude.py]"]
  node_plugins["Plugins<br/>[myclaude.py]"]
  node_extensions_view["MCP and plugins page<br/>[extensions.html]"]
  node_system["System settings<br/>[myclaude.py]"]
  node_system_view["System page<br/>[system.html]"]
  node_memory["Memory history<br/>[myclaude.py]"]
end

subgraph group_state["Local state"]
  node_claude_files[("Claude Code files")]
  node_app_data[("User data")]
  node_cache[("Derived caches<br/>[myclaude.py]")]
end

node_user(("Local user"))
node_anthropic["Anthropic API"]
node_github["GitHub"]
node_mcp_services["MCP services"]

node_user -->|"opens dashboard"| node_server
node_server -->|"renders"| node_overview
node_server -->|"routes to"| node_usage
node_usage -->|"renders"| node_usage_view
node_server -->|"routes to"| node_history
node_history -->|"renders"| node_history_view
node_server -->|"routes to"| node_skills
node_skills -->|"renders"| node_skills_view
node_server -->|"loads"| node_connectors
node_server -->|"loads"| node_plugins
node_server -->|"renders"| node_extensions_view
node_server -->|"routes to"| node_system
node_system -->|"renders"| node_system_view
node_system -->|"reads"| node_memory
node_usage -->|"reads transcripts"| node_claude_files
node_history -->|"reads conversations"| node_claude_files
node_skills -->|"reads skills"| node_claude_files
node_connectors -->|"reads configs"| node_claude_files
node_system -->|"reads settings"| node_claude_files
node_server -->|"stores preferences"| node_app_data
node_usage -->|"uses cached data"| node_cache
node_usage -.->|"fetches plan limits"| node_anthropic
node_connectors -.->|"checks health"| node_mcp_services
node_skills -.->|"pushes skill"| node_github

click node_server "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"
click node_overview "https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/overview.html"
click node_usage "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"
click node_usage_view "https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/token.html"
click node_history "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"
click node_history_view "https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/history.html"
click node_skills "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"
click node_skills_view "https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/skills.html"
click node_connectors "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"
click node_plugins "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"
click node_extensions_view "https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/extensions.html"
click node_system "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"
click node_system_view "https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/system.html"
click node_memory "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"
click node_cache "https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py"

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_server,node_overview,node_user toneBlue
class node_usage,node_usage_view,node_history,node_history_view toneAmber
class node_skills,node_skills_view,node_connectors,node_plugins,node_extensions_view,node_system,node_system_view,node_memory,node_anthropic toneMint
class node_claude_files,node_app_data,node_cache toneRose
class node_github,node_mcp_services toneIndigo
```

## Components

### Dashboard runtime

- [Dashboard server](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`
- [Overview](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/overview.html): `app/templates/overview.html`

### Activity insights

- [Usage analytics](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`
- [Usage page](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/token.html): `app/templates/token.html`
- [Conversation history](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`
- [History page](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/history.html): `app/templates/history.html`

### Configuration management

- [Skills browser](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`
- [Skills page](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/skills.html): `app/templates/skills.html`
- [MCP servers](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`
- [Plugins](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`
- [MCP and plugins page](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/extensions.html): `app/templates/extensions.html`
- [System settings](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`
- [System page](https://github.com/chethanbhatbs/my-claude/blob/main/app/templates/system.html): `app/templates/system.html`
- [Memory history](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`

### Local state

- **Claude Code files**
- **User data**
- [Derived caches](https://github.com/chethanbhatbs/my-claude/blob/main/app/myclaude.py): `app/myclaude.py`

### Other components

- **Local user**
- **Anthropic API**
- **GitHub**
- **MCP services**

## Connections

- Local user → Dashboard server: opens dashboard (evidence: `README.md`)
- Dashboard server → Overview: renders (evidence: `README.md`)
- Dashboard server → Usage analytics: routes to (evidence: `app/myclaude.py`)
- Usage analytics → Usage page: renders (evidence: `app/myclaude.py`)
- Dashboard server → Conversation history: routes to (evidence: `README.md`)
- Conversation history → History page: renders (evidence: `README.md`)
- Dashboard server → Skills browser: routes to (evidence: `app/myclaude.py`)
- Skills browser → Skills page: renders (evidence: `README.md`)
- Dashboard server → MCP servers: loads (evidence: `README.md`)
- Dashboard server → Plugins: loads (evidence: `README.md`)
- Dashboard server → MCP and plugins page: renders (evidence: `README.md`)
- Dashboard server → System settings: routes to (evidence: `README.md`)
- System settings → System page: renders (evidence: `README.md`)
- System settings → Memory history: reads (evidence: `README.md`)
- Usage analytics → Claude Code files: reads transcripts (evidence: `README.md`)
- Conversation history → Claude Code files: reads conversations (evidence: `README.md`)
- Skills browser → Claude Code files: reads skills (evidence: `README.md`)
- MCP servers → Claude Code files: reads configs (evidence: `README.md`)
- System settings → Claude Code files: reads settings (evidence: `README.md`)
- Dashboard server → User data: stores preferences (evidence: `README.md`)
- Usage analytics → Derived caches: uses cached data (evidence: `app/myclaude.py`)
- Usage analytics → Anthropic API: fetches plan limits (evidence: `README.md`)
- MCP servers → MCP services: checks health (evidence: `README.md`)
- Skills browser → GitHub: pushes skill (evidence: `README.md`)
