# technolabyte/clipboard_wizard architecture

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

- Interactive diagram: https://gitdiagram.com/technolabyte/clipboard_wizard
- Repository: https://github.com/technolabyte/clipboard_wizard

## Overview

Clipboard Wizard is a Windows tray app that turns clipboard changes into context-sensitive actions. Its main path is copy/re-copy or image copy → clipboard monitoring and payload capture → command registry and popup → selected command → clipboard, file, or external result. The graph preserves research, scripts, image tools, collection modes, Explorer naming, and audit logging. Several subsystems are represented from README and SOURCE INDEX references rather than inspected implementations, so their internal links are limited to documented relationships.

Main entry points: [`Services/CommandRegistry.cs`](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/CommandRegistry.cs) (Command registry), [`App.xaml.cs`](https://github.com/technolabyte/clipboard_wizard/blob/master/App.xaml.cs) (App startup), [`Commands/ReformatLlmCommand.cs`](https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/ReformatLlmCommand.cs) (Reformat actions), [`Services/ImageIO.cs`](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ImageIO.cs) (Image I/O)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and UI"]
  node_app["App startup<br/>[App.xaml.cs]"]
  node_monitor["Clipboard monitor"]
  node_payload["Clipboard payload"]
  node_registry["Command registry<br/>[CommandRegistry.cs]"]
  node_popup["Command popup"]
end

subgraph group_commands["Clipboard actions"]
  node_command["Command interface"]
  node_scripts["Python scripts"]
  node_reformat["Reformat actions"]
  node_powershell["PowerShell action"]
end

subgraph group_media["Images and collection"]
  node_image_actions["Image operations"]
  node_transform["Image transform"]
  node_image_io["Image I/O<br/>[ImageIO.cs]"]
  node_naming["Intelligent naming<br/>[IntelligentName.cs]"]
  node_collect["Clipboard collection<br/>[Hawk.cs]"]
  node_cycle["Clipboard cycle<br/>[ClipboardCycle.cs]"]
  node_screenshot["Screenshot swap<br/>[ScreenshotSwap.cs]"]
end

subgraph group_ai["AI and integrations"]
  node_research["Research actions"]
  node_search["Online search"]
  node_claude_session["Interactive Claude<br/>[ClaudeSession.cs]"]
  node_seeds["Cached AI seeds<br/>[Seeds.cs]"]
end

subgraph group_runtime["Runtime support"]
  node_log[("Action audit log<br/>[ActionLog.cs]")]
  node_writer["Clipboard writer<br/>[ClipboardWriter.cs]"]
  node_paths["Working-area paths<br/>[AppPaths.cs]"]
end

node_user(("Windows user"))
node_clipboard[("Windows clipboard")]
node_claude_cli["Claude CLI"]

node_user -->|"copies content"| node_clipboard
node_app -->|"starts"| node_monitor
node_monitor -.->|"captures"| node_payload
node_app -->|"initializes"| node_registry
node_registry -->|"registers"| node_scripts
node_registry -->|"registers"| node_research
node_registry -->|"registers"| node_search
node_registry -->|"registers"| node_image_actions
node_registry -->|"registers"| node_transform
node_registry -->|"registers"| node_reformat
node_popup -->|"uses"| node_payload
node_popup -->|"dispatches"| node_command
node_popup -.->|"loads actions"| node_registry
node_scripts -->|"writes result"| node_writer
node_reformat -->|"runs prompt"| node_seeds
node_reformat -->|"writes result"| node_writer
node_research -->|"launches session"| node_claude_session
node_claude_session -->|"launches"| node_claude_cli
node_seeds -->|"runs forks"| node_claude_cli
node_search -->|"reads payload"| node_clipboard
node_image_actions -->|"uses image files"| node_image_io
node_transform -->|"materializes image"| node_image_io
node_transform -->|"writes result"| node_writer
node_naming -->|"loads images"| node_image_io
node_app -->|"initializes"| node_naming
node_app -->|"initializes"| node_collect
node_app -->|"initializes"| node_cycle
node_app -->|"initializes"| node_screenshot
node_collect -->|"updates clipboard"| node_writer
node_screenshot -->|"uses image conversion"| node_image_io
node_research -->|"records action"| node_log
node_reformat -->|"records action"| node_log
node_log -->|"writes under"| node_paths
node_app -.->|"initializes area"| node_paths

click node_app "https://github.com/technolabyte/clipboard_wizard/blob/master/App.xaml.cs"
click node_monitor "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ClipboardMonitor.cs"
click node_payload "https://github.com/technolabyte/clipboard_wizard/blob/master/Models/ClipboardPayload.cs"
click node_registry "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/CommandRegistry.cs"
click node_popup "https://github.com/technolabyte/clipboard_wizard/blob/master/UI/CommandPopup.xaml.cs"
click node_command "https://github.com/technolabyte/clipboard_wizard/blob/master/Models/IClipboardCommand.cs"
click node_scripts "https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/PythonScriptCommand.cs"
click node_reformat "https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/ReformatLlmCommand.cs"
click node_powershell "https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/PowerShellCommand.cs"
click node_research "https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/AskClaudeCommand.cs"
click node_search "https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/SearchOnlineCommand.cs"
click node_claude_session "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ClaudeSession.cs"
click node_image_actions "https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/ImageConversionCommands.cs"
click node_transform "https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/TransformImageCommand.cs"
click node_image_io "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ImageIO.cs"
click node_naming "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/IntelligentName.cs"
click node_collect "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/Hawk.cs"
click node_cycle "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ClipboardCycle.cs"
click node_screenshot "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ScreenshotSwap.cs"
click node_log "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ActionLog.cs"
click node_writer "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ClipboardWriter.cs"
click node_seeds "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/Seeds.cs"
click node_paths "https://github.com/technolabyte/clipboard_wizard/blob/master/Services/AppPaths.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_app,node_monitor,node_payload,node_registry,node_popup,node_user toneBlue
class node_command,node_scripts,node_reformat,node_powershell,node_clipboard toneAmber
class node_image_actions,node_transform,node_image_io,node_naming,node_collect,node_cycle,node_screenshot toneMint
class node_research,node_search,node_claude_session,node_seeds toneRose
class node_log,node_writer,node_paths,node_claude_cli toneIndigo
```

## Components

### Capture and UI

- [App startup](https://github.com/technolabyte/clipboard_wizard/blob/master/App.xaml.cs): `App.xaml.cs`
- [Clipboard monitor](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ClipboardMonitor.cs): `Services/ClipboardMonitor.cs`
- [Clipboard payload](https://github.com/technolabyte/clipboard_wizard/blob/master/Models/ClipboardPayload.cs): `Models/ClipboardPayload.cs`
- [Command registry](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/CommandRegistry.cs): `Services/CommandRegistry.cs`
- [Command popup](https://github.com/technolabyte/clipboard_wizard/blob/master/UI/CommandPopup.xaml.cs): `UI/CommandPopup.xaml.cs`

### Clipboard actions

- [Command interface](https://github.com/technolabyte/clipboard_wizard/blob/master/Models/IClipboardCommand.cs): `Models/IClipboardCommand.cs`
- [Python scripts](https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/PythonScriptCommand.cs): `Commands/PythonScriptCommand.cs`
- [Reformat actions](https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/ReformatLlmCommand.cs): `Commands/ReformatLlmCommand.cs`
- [PowerShell action](https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/PowerShellCommand.cs): `Commands/PowerShellCommand.cs`

### Images and collection

- [Image operations](https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/ImageConversionCommands.cs): `Commands/ImageConversionCommands.cs`
- [Image transform](https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/TransformImageCommand.cs): `Commands/TransformImageCommand.cs`
- [Image I/O](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ImageIO.cs): `Services/ImageIO.cs`
- [Intelligent naming](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/IntelligentName.cs): `Services/IntelligentName.cs`
- [Clipboard collection](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/Hawk.cs): `Services/Hawk.cs`
- [Clipboard cycle](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ClipboardCycle.cs): `Services/ClipboardCycle.cs`
- [Screenshot swap](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ScreenshotSwap.cs): `Services/ScreenshotSwap.cs`

### AI and integrations

- [Research actions](https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/AskClaudeCommand.cs): `Commands/AskClaudeCommand.cs`
- [Online search](https://github.com/technolabyte/clipboard_wizard/blob/master/Commands/SearchOnlineCommand.cs): `Commands/SearchOnlineCommand.cs`
- [Interactive Claude](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ClaudeSession.cs): `Services/ClaudeSession.cs`
- [Cached AI seeds](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/Seeds.cs): `Services/Seeds.cs`

### Runtime support

- [Action audit log](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ActionLog.cs): `Services/ActionLog.cs`
- [Clipboard writer](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/ClipboardWriter.cs): `Services/ClipboardWriter.cs`
- [Working-area paths](https://github.com/technolabyte/clipboard_wizard/blob/master/Services/AppPaths.cs): `Services/AppPaths.cs`

### Other components

- **Windows user**
- **Windows clipboard**
- **Claude CLI**

## Connections

- Windows user → Windows clipboard: copies content (evidence: `README.md`)
- App startup → Clipboard monitor: starts (evidence: `App.xaml.cs`)
- Clipboard monitor → Clipboard payload: captures
- App startup → Command registry: initializes (evidence: `App.xaml.cs`)
- Command registry → Python scripts: registers (evidence: `Services/CommandRegistry.cs`)
- Command registry → Research actions: registers (evidence: `Services/CommandRegistry.cs`)
- Command registry → Online search: registers (evidence: `Services/CommandRegistry.cs`)
- Command registry → Image operations: registers (evidence: `Services/CommandRegistry.cs`)
- Command registry → Image transform: registers (evidence: `Services/CommandRegistry.cs`)
- Command registry → Reformat actions: registers (evidence: `Services/CommandRegistry.cs`)
- Command popup → Clipboard payload: uses (evidence: `UI/CommandPopup.xaml.cs`)
- Command popup → Command interface: dispatches (evidence: `UI/CommandPopup.xaml.cs`)
- Command popup → Command registry: loads actions
- Python scripts → Clipboard writer: writes result (evidence: `Commands/PythonScriptCommand.cs`)
- Reformat actions → Cached AI seeds: runs prompt (evidence: `Commands/ReformatLlmCommand.cs`)
- Reformat actions → Clipboard writer: writes result (evidence: `Commands/ReformatLlmCommand.cs`)
- Research actions → Interactive Claude: launches session (evidence: `Commands/AskClaudeCommand.cs`)
- Interactive Claude → Claude CLI: launches (evidence: `Services/ClaudeSession.cs`)
- Cached AI seeds → Claude CLI: runs forks (evidence: `Services/Seeds.cs`)
- Online search → Windows clipboard: reads payload (evidence: `Commands/SearchOnlineCommand.cs`)
- Image operations → Image I/O: uses image files (evidence: `Commands/ImageConversionCommands.cs`)
- Image transform → Image I/O: materializes image (evidence: `Commands/TransformImageCommand.cs`)
- Image transform → Clipboard writer: writes result (evidence: `Commands/TransformImageCommand.cs`)
- Intelligent naming → Image I/O: loads images (evidence: `Services/IntelligentName.cs`)
- App startup → Intelligent naming: initializes (evidence: `App.xaml.cs`)
- App startup → Clipboard collection: initializes (evidence: `App.xaml.cs`)
- App startup → Clipboard cycle: initializes (evidence: `App.xaml.cs`)
- App startup → Screenshot swap: initializes (evidence: `App.xaml.cs`)
- Clipboard collection → Clipboard writer: updates clipboard (evidence: `Services/Hawk.cs`)
- Screenshot swap → Image I/O: uses image conversion (evidence: `Services/ScreenshotSwap.cs`)
- Research actions → Action audit log: records action (evidence: `Commands/AskClaudeCommand.cs`)
- Reformat actions → Action audit log: records action (evidence: `Commands/ReformatLlmCommand.cs`)
- Action audit log → Working-area paths: writes under (evidence: `Services/ActionLog.cs`)
- App startup → Working-area paths: initializes area (evidence: `App.xaml.cs`)
