# dream-rainy/cursorhide architecture

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

- Interactive diagram: https://gitdiagram.com/dream-rainy/cursorhide
- Repository: https://github.com/dream-rainy/cursorhide

## Overview

CursorHide is a Windows .NET tray application that hides the system pointer after qualifying keyboard input and restores it after pointer movement or other recovery events. Its main workflow runs from input monitoring through context and input classification, state coordination, and native cursor presentation; settings, exclusions, tooltip protection, and crash recovery extend that workflow. The README documents these capabilities, while some implementation details are unsampled, so uncertain links are omitted.

Main entry points: [`src/CursorHide/Core/CursorCoordinator.cs`](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Core/CursorCoordinator.cs) (Cursor coordinator), [`src/CursorHide/Recovery/SystemCursorController.cs`](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/SystemCursorController.cs) (System cursor control), [`src/CursorHide/UI/TrayApplicationContext.cs`](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/UI/TrayApplicationContext.cs) (Tray application), [`src/CursorHide/Program.cs`](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Program.cs) (Application startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and input"]
  node_program["Application startup<br/>[Program.cs]"]
  node_inputmonitor["Input monitor"]
  node_session["Session monitor"]
  node_coordinator["Cursor coordinator"]
end

subgraph group_decision["Input and context"]
  node_classifier["Input classifier<br/>[InputClassifier.cs]"]
  node_state["Cursor state machine"]
  node_contextprovider["Foreground context"]
  node_exclusions["Exclusion policy<br/>[ExclusionPolicy.cs]"]
end

subgraph group_cursor["Cursor and recovery"]
  node_cursorcontroller["System cursor control"]
  node_imagefactory["Cursor image factory"]
  node_schemes["Cursor scheme catalog"]
  node_restore["Recovery executor"]
  node_roles["System cursor roles"]
  node_markers[("Recovery markers")]
  node_watchdog["Recovery watchdog<br/>[WatchdogManager.cs]"]
end

subgraph group_tooltip["Tooltip protection"]
  node_tooltipmonitor["Tooltip monitor<br/>[TooltipMonitor.cs]"]
  node_tooltipinspect["UI Automation inspector"]
  node_tooltipclassify["Passive tooltip classifier"]
end

subgraph group_settings["Settings and tray"]
  node_tray["Tray application"]
  node_settingsform["Settings form<br/>[SettingsForm.cs]"]
  node_settingsstore[("Settings store<br/>[SettingsStore.cs]")]
  node_hotkey["Global hotkey"]
  node_startup["Startup registration<br/>[StartupManager.cs]"]
end

node_user(("User"))
node_keyboard(("Keyboard input"))
node_mouse(("Mouse movement"))
node_windows["Windows APIs"]

node_user -->|"types"| node_keyboard
node_user -->|"moves pointer"| node_mouse
node_keyboard -.->|"emits events"| node_inputmonitor
node_mouse -.->|"emits events"| node_inputmonitor
node_program -->|"starts"| node_inputmonitor
node_program -->|"creates"| node_coordinator
node_program -->|"starts"| node_tooltipmonitor
node_program -->|"starts"| node_session
node_program -->|"runs"| node_tray
node_inputmonitor -->|"posts events"| node_coordinator
node_tooltipmonitor -->|"posts events"| node_coordinator
node_session -->|"posts events"| node_coordinator
node_coordinator -->|"classifies input"| node_classifier
node_coordinator -->|"updates state"| node_state
node_coordinator -.->|"captures context"| node_contextprovider
node_contextprovider -->|"checks exclusions"| node_exclusions
node_coordinator -.->|"controls presentation"| node_cursorcontroller
node_coordinator -->|"tracks candidates"| node_tooltipmonitor
node_tooltipmonitor -->|"inspects elements"| node_tooltipinspect
node_tooltipmonitor -->|"classifies candidates"| node_tooltipclassify
node_cursorcontroller -->|"creates cursor image"| node_imagefactory
node_cursorcontroller -->|"snapshots scheme"| node_schemes
node_cursorcontroller -->|"restores scheme"| node_restore
node_restore -->|"uses roles"| node_roles
node_cursorcontroller -.->|"writes recovery marker"| node_markers
node_cursorcontroller -.->|"ensures watchdog"| node_watchdog
node_cursorcontroller -->|"installs system cursor"| node_windows
node_user -->|"operates"| node_tray
node_tray -->|"posts commands"| node_coordinator
node_tray -->|"opens"| node_settingsform
node_tray -->|"saves settings"| node_settingsstore
node_tray -->|"registers shortcut"| node_hotkey
node_tray -->|"sets startup"| node_startup
node_program -->|"loads settings"| node_settingsstore
node_settingsform -->|"lists schemes"| node_schemes

click node_program "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Program.cs"
click node_inputmonitor "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Hooks/LowLevelInputMonitor.cs"
click node_session "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Services/SessionChangeMonitor.cs"
click node_coordinator "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Core/CursorCoordinator.cs"
click node_classifier "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Core/InputClassifier.cs"
click node_state "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Core/CursorStateMachine.cs"
click node_contextprovider "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Context/ForegroundContextProvider.cs"
click node_exclusions "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Context/ExclusionPolicy.cs"
click node_cursorcontroller "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/SystemCursorController.cs"
click node_imagefactory "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/SystemCursorImageFactory.cs"
click node_schemes "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/CursorSchemeCatalog.cs"
click node_restore "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/CursorRecoveryExecutor.cs"
click node_roles "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/SystemCursorRoles.cs"
click node_markers "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/RecoveryMarkerStore.cs"
click node_watchdog "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/WatchdogManager.cs"
click node_tooltipmonitor "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Tooltips/TooltipMonitor.cs"
click node_tooltipinspect "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Tooltips/AutomationTooltipInspector.cs"
click node_tooltipclassify "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Tooltips/PassiveTooltipClassifier.cs"
click node_tray "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/UI/TrayApplicationContext.cs"
click node_settingsform "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/UI/SettingsForm.cs"
click node_settingsstore "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Services/SettingsStore.cs"
click node_hotkey "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Services/GlobalHotkeyManager.cs"
click node_startup "https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Services/StartupManager.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_program,node_inputmonitor,node_session,node_coordinator,node_user toneBlue
class node_classifier,node_state,node_contextprovider,node_exclusions toneAmber
class node_cursorcontroller,node_imagefactory,node_schemes,node_restore,node_roles,node_markers,node_watchdog,node_windows toneMint
class node_tooltipmonitor,node_tooltipinspect,node_tooltipclassify toneRose
class node_tray,node_settingsform,node_settingsstore,node_hotkey,node_startup,node_keyboard,node_mouse toneIndigo
```

## Components

### Runtime and input

- [Application startup](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Program.cs): `src/CursorHide/Program.cs`
- [Input monitor](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Hooks/LowLevelInputMonitor.cs): `src/CursorHide/Hooks/LowLevelInputMonitor.cs`
- [Session monitor](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Services/SessionChangeMonitor.cs): `src/CursorHide/Services/SessionChangeMonitor.cs`
- [Cursor coordinator](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Core/CursorCoordinator.cs): `src/CursorHide/Core/CursorCoordinator.cs`

### Input and context

- [Input classifier](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Core/InputClassifier.cs): `src/CursorHide/Core/InputClassifier.cs`
- [Cursor state machine](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Core/CursorStateMachine.cs): `src/CursorHide/Core/CursorStateMachine.cs`
- [Foreground context](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Context/ForegroundContextProvider.cs): `src/CursorHide/Context/ForegroundContextProvider.cs`
- [Exclusion policy](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Context/ExclusionPolicy.cs): `src/CursorHide/Context/ExclusionPolicy.cs`

### Cursor and recovery

- [System cursor control](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/SystemCursorController.cs): `src/CursorHide/Recovery/SystemCursorController.cs`
- [Cursor image factory](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/SystemCursorImageFactory.cs): `src/CursorHide/Recovery/SystemCursorImageFactory.cs`
- [Cursor scheme catalog](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/CursorSchemeCatalog.cs): `src/CursorHide/Recovery/CursorSchemeCatalog.cs`
- [Recovery executor](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/CursorRecoveryExecutor.cs): `src/CursorHide/Recovery/CursorRecoveryExecutor.cs`
- [System cursor roles](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/SystemCursorRoles.cs): `src/CursorHide/Recovery/SystemCursorRoles.cs`
- [Recovery markers](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/RecoveryMarkerStore.cs): `src/CursorHide/Recovery/RecoveryMarkerStore.cs`
- [Recovery watchdog](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Recovery/WatchdogManager.cs): `src/CursorHide/Recovery/WatchdogManager.cs`

### Tooltip protection

- [Tooltip monitor](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Tooltips/TooltipMonitor.cs): `src/CursorHide/Tooltips/TooltipMonitor.cs`
- [UI Automation inspector](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Tooltips/AutomationTooltipInspector.cs): `src/CursorHide/Tooltips/AutomationTooltipInspector.cs`
- [Passive tooltip classifier](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Tooltips/PassiveTooltipClassifier.cs): `src/CursorHide/Tooltips/PassiveTooltipClassifier.cs`

### Settings and tray

- [Tray application](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/UI/TrayApplicationContext.cs): `src/CursorHide/UI/TrayApplicationContext.cs`
- [Settings form](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/UI/SettingsForm.cs): `src/CursorHide/UI/SettingsForm.cs`
- [Settings store](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Services/SettingsStore.cs): `src/CursorHide/Services/SettingsStore.cs`
- [Global hotkey](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Services/GlobalHotkeyManager.cs): `src/CursorHide/Services/GlobalHotkeyManager.cs`
- [Startup registration](https://github.com/dream-rainy/cursorhide/blob/main/src/CursorHide/Services/StartupManager.cs): `src/CursorHide/Services/StartupManager.cs`

### Other components

- **User**
- **Keyboard input**
- **Mouse movement**
- **Windows APIs**

## Connections

- User → Keyboard input: types
- User → Mouse movement: moves pointer
- Keyboard input → Input monitor: emits events
- Mouse movement → Input monitor: emits events
- Application startup → Input monitor: starts (evidence: `src/CursorHide/Program.cs`)
- Application startup → Cursor coordinator: creates (evidence: `src/CursorHide/Program.cs`)
- Application startup → Tooltip monitor: starts (evidence: `src/CursorHide/Program.cs`)
- Application startup → Session monitor: starts (evidence: `src/CursorHide/Program.cs`)
- Application startup → Tray application: runs (evidence: `src/CursorHide/Program.cs`)
- Input monitor → Cursor coordinator: posts events (evidence: `src/CursorHide/Program.cs`)
- Tooltip monitor → Cursor coordinator: posts events (evidence: `src/CursorHide/Program.cs`)
- Session monitor → Cursor coordinator: posts events (evidence: `src/CursorHide/Program.cs`)
- Cursor coordinator → Input classifier: classifies input (evidence: `src/CursorHide/Core/CursorCoordinator.cs`)
- Cursor coordinator → Cursor state machine: updates state (evidence: `src/CursorHide/Core/CursorCoordinator.cs`)
- Cursor coordinator → Foreground context: captures context
- Foreground context → Exclusion policy: checks exclusions (evidence: `src/CursorHide/Context/ForegroundContextProvider.cs`)
- Cursor coordinator → System cursor control: controls presentation
- Cursor coordinator → Tooltip monitor: tracks candidates (evidence: `src/CursorHide/Core/CursorCoordinator.cs`)
- Tooltip monitor → UI Automation inspector: inspects elements (evidence: `src/CursorHide/Tooltips/TooltipMonitor.cs`)
- Tooltip monitor → Passive tooltip classifier: classifies candidates (evidence: `src/CursorHide/Tooltips/TooltipMonitor.cs`)
- System cursor control → Cursor image factory: creates cursor image (evidence: `src/CursorHide/Recovery/SystemCursorController.cs`)
- System cursor control → Cursor scheme catalog: snapshots scheme (evidence: `src/CursorHide/Recovery/SystemCursorController.cs`)
- System cursor control → Recovery executor: restores scheme (evidence: `src/CursorHide/Recovery/SystemCursorController.cs`)
- Recovery executor → System cursor roles: uses roles (evidence: `src/CursorHide/Recovery/CursorRecoveryExecutor.cs`)
- System cursor control → Recovery markers: writes recovery marker
- System cursor control → Recovery watchdog: ensures watchdog
- System cursor control → Windows APIs: installs system cursor (evidence: `src/CursorHide/Recovery/SystemCursorController.cs`)
- User → Tray application: operates
- Tray application → Cursor coordinator: posts commands (evidence: `src/CursorHide/UI/TrayApplicationContext.cs`)
- Tray application → Settings form: opens (evidence: `src/CursorHide/UI/TrayApplicationContext.cs`)
- Tray application → Settings store: saves settings (evidence: `src/CursorHide/UI/TrayApplicationContext.cs`)
- Tray application → Global hotkey: registers shortcut (evidence: `src/CursorHide/UI/TrayApplicationContext.cs`)
- Tray application → Startup registration: sets startup (evidence: `src/CursorHide/UI/TrayApplicationContext.cs`)
- Application startup → Settings store: loads settings (evidence: `src/CursorHide/Program.cs`)
- Settings form → Cursor scheme catalog: lists schemes (evidence: `src/CursorHide/UI/SettingsForm.cs`)
