# bowen-yao1/cutepet architecture

> Architecture diagram of the GitHub repository bowen-yao1/cutepet, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bowen-yao1/cutepet
- Repository: https://github.com/bowen-yao1/cutepet

## Overview

CutePet is a planned Windows desktop pet that displays Codex quota and reset information; the README explicitly says no runnable program exists yet. The intended workflow is to connect an account, synchronize official usage results, and show quota and freshness status alongside an animated pet. The graph captures documented capabilities, not implemented modules. No source excerpts were provided, so component paths are null and relationships are limited to those described in the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_account_sync["Account and Sync"]
  node_account_connection["Account Connection"]
  node_usage_sync["Usage Sync"]
  node_refresh["Automatic Refresh"]
end

subgraph group_display["Quota Display"]
  node_quota_window["Quota Window"]
  node_remaining_quota["Remaining Percentage"]
  node_reset_countdown["Reset Countdown"]
  node_connection_status["Connection Status"]
  node_stale_status["Stale Data Status"]
  node_quota_panel["Quota Panel"]
end

subgraph group_pet["Desktop Pet"]
  node_pet_window["Transparent Pet Window"]
  node_pet_controls["Window Controls"]
  node_tray_controls["Tray Controls"]
  node_character_animation["Character Animation"]
  node_click_response["Click Response"]
  node_low_quota_expression["Low-Quota Expression"]
end

node_user(("User"))
node_codex_cli["Codex CLI"]
node_official_data[("Official Usage Data")]

node_user -->|"connects account"| node_account_connection
node_codex_cli -->|"provides dependency"| node_account_connection
node_account_connection -->|"enables sync"| node_usage_sync
node_official_data -->|"provides results"| node_usage_sync
node_usage_sync -->|"supplies returned window"| node_quota_window
node_usage_sync -->|"supplies remaining amount"| node_remaining_quota
node_usage_sync -->|"supplies reset time"| node_reset_countdown
node_refresh -->|"refreshes data"| node_usage_sync
node_usage_sync -->|"reports disconnection"| node_connection_status
node_usage_sync -->|"marks old data"| node_stale_status
node_user -->|"drags and resizes"| node_pet_controls
node_user -->|"uses tray"| node_tray_controls
node_pet_window -->|"hosts panel"| node_quota_panel
node_pet_window -->|"shows animation"| node_character_animation
node_user -->|"clicks pet"| node_click_response
node_remaining_quota -->|"drives expression"| node_low_quota_expression

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_account_connection,node_usage_sync,node_refresh,node_user toneBlue
class node_quota_window,node_remaining_quota,node_reset_countdown,node_connection_status,node_stale_status,node_quota_panel,node_official_data toneAmber
class node_pet_window,node_pet_controls,node_tray_controls,node_character_animation,node_click_response,node_low_quota_expression toneMint
class node_codex_cli toneIndigo
```

## Components

### Account and Sync

- **Account Connection**
- **Usage Sync**
- **Automatic Refresh**

### Quota Display

- **Quota Window**
- **Remaining Percentage**
- **Reset Countdown**
- **Connection Status**
- **Stale Data Status**
- **Quota Panel**

### Desktop Pet

- **Transparent Pet Window**
- **Window Controls**
- **Tray Controls**
- **Character Animation**
- **Click Response**
- **Low-Quota Expression**

### Other components

- **User**
- **Codex CLI**
- **Official Usage Data**

## Connections

- User → Account Connection: connects account (evidence: `README.md`)
- Codex CLI → Account Connection: provides dependency (evidence: `README.md`)
- Account Connection → Usage Sync: enables sync (evidence: `README.md`)
- Official Usage Data → Usage Sync: provides results (evidence: `README.md`)
- Usage Sync → Quota Window: supplies returned window (evidence: `README.md`)
- Usage Sync → Remaining Percentage: supplies remaining amount (evidence: `README.md`)
- Usage Sync → Reset Countdown: supplies reset time (evidence: `README.md`)
- Automatic Refresh → Usage Sync: refreshes data (evidence: `README.md`)
- Usage Sync → Connection Status: reports disconnection (evidence: `README.md`)
- Usage Sync → Stale Data Status: marks old data (evidence: `README.md`)
- User → Window Controls: drags and resizes (evidence: `README.md`)
- User → Tray Controls: uses tray (evidence: `README.md`)
- Transparent Pet Window → Quota Panel: hosts panel (evidence: `README.md`)
- Transparent Pet Window → Character Animation: shows animation (evidence: `README.md`)
- User → Click Response: clicks pet (evidence: `README.md`)
- Remaining Percentage → Low-Quota Expression: drives expression (evidence: `README.md`)
