# zihangdong/toolknit-desktop architecture

> Architecture diagram of the GitHub repository zihangdong/toolknit-desktop, 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/zihangdong/toolknit-desktop
- Repository: https://github.com/zihangdong/toolknit-desktop

## Overview

ToolKnit Desktop is a local-first file-workbench product spanning a visual desktop application and automation through its CLI/MCP interface. The main user flow is selecting a tool and local file, processing or editing it, then exporting a result; AI-assisted document and presentation workflows add provider-backed analysis. The graph retains major documented PDF, PPT, media, image, developer-tool, and clipboard capabilities. Evidence is limited to the README and sampled/indexed source references, so unsampled feature connections are documented rather than inferred as direct calls.

Main entry points: [`toolknit-desktop/src/app/app-composition.js`](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/app/app-composition.js) (Desktop workbench), [`toolknit-desktop/cli/toolknit.mjs`](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/cli/toolknit.mjs) (CLI entry), [`toolknit-desktop/src-tauri/src/native_runtime.rs`](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src-tauri/src/native_runtime.rs) (Native runtime), [`toolknit-desktop/src/platform/tauri-runtime.js`](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/platform/tauri-runtime.js) (Tauri bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["Desktop workbench<br/>[app-composition.js]"]
  node_lifecycle["Tool lifecycle<br/>[tool-lifecycle.js]"]
end

subgraph group_documents["Document workflows"]
  node_pdfedit["PDF editor<br/>[controller.js]"]
  node_pdftext["PDF text to Markdown<br/>[controller.js]"]
  node_pdfai["AI PDF conversion<br/>[pipeline.js]"]
  node_pptdraft["PPT drafting<br/>[controller.js]"]
  node_pptimages["PPT image workflow<br/>[controller.js]"]
  node_pptshared["PPT workflow support<br/>[shared.js]"]
  node_markdown["Markdown editor<br/>[controller.js]"]
end

subgraph group_media["Media and utilities"]
  node_image["Image tools<br/>[controller.js]"]
  node_audio["Audio tools<br/>[clip-controller.js]"]
  node_video["Video tools<br/>[gif-controller.js]"]
  node_teleprompter["Teleprompter<br/>[controller.js]"]
  node_clipboard["Clipboard history<br/>[controller.js]"]
end

subgraph group_automation["CLI and agents"]
  node_cli["CLI entry<br/>[toolknit.mjs]"]
  node_registry["Tool registry<br/>[tool-registry.mjs]"]
  node_mcp["MCP server<br/>[mcp-server.mjs]"]
end

subgraph group_platform["Local platform"]
  node_native["Native runtime<br/>[native_runtime.rs]"]
  node_tauri["Tauri bridge<br/>[tauri-runtime.js]"]
  node_store[("Clipboard store<br/>[store.rs]")]
end

node_user(("User"))
node_ai{{"Configured AI provider"}}

node_user -->|"uses workbench"| node_app
node_app -.->|"manages tools"| node_lifecycle
node_app -.->|"opens tools"| node_pdfedit
node_app -.->|"opens tools"| node_pdftext
node_app -.->|"opens tools"| node_pdfai
node_app -.->|"opens tools"| node_pptdraft
node_app -.->|"opens tools"| node_pptimages
node_app -.->|"opens tools"| node_markdown
node_pdfedit -->|"uses bridge"| node_tauri
node_pptdraft -->|"uses file helpers"| node_pptshared
node_pptimages -->|"uses workflow helpers"| node_pptshared
node_pdfai -->|"requests analysis"| node_ai
node_user -->|"runs commands"| node_cli
node_cli -->|"dispatches tools"| node_registry
node_cli -->|"starts server"| node_mcp
node_cli -.->|"uses configured provider"| node_ai
node_image -->|"uses bridge"| node_tauri
node_audio -->|"uses bridge"| node_tauri
node_teleprompter -->|"uses bridge"| node_tauri
node_clipboard -.->|"records locally"| node_native
node_native -.->|"persists history"| node_store
node_pdfedit -.->|"uses local processing"| node_native
node_pptdraft -->|"reads and writes files"| node_native
node_user -->|"uses image tools"| node_image
node_user -->|"uses media tools"| node_audio
node_user -->|"uses media tools"| node_video
node_user -->|"uses presentation aid"| node_teleprompter
node_user -->|"reviews copied items"| node_clipboard
node_pdftext -->|"continues editing"| node_markdown

click node_app "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/app/app-composition.js"
click node_lifecycle "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/app/tool-lifecycle.js"
click node_pdfedit "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/pdf-editor/controller.js"
click node_pdftext "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/pdf-text-extract/controller.js"
click node_pdfai "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/pdf-ai-markdown/pipeline.js"
click node_pptdraft "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/ppt-draft/controller.js"
click node_pptimages "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/ppt-images/controller.js"
click node_pptshared "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/ppt-workflows/shared.js"
click node_markdown "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/markdown-editor/controller.js"
click node_image "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/image-stitch/controller.js"
click node_audio "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/audio-tools/clip-controller.js"
click node_video "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/video-tools/gif-controller.js"
click node_teleprompter "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/teleprompter/controller.js"
click node_clipboard "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/clipboard-history/controller.js"
click node_cli "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/cli/toolknit.mjs"
click node_registry "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/cli/lib/tool-registry.mjs"
click node_mcp "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/cli/lib/mcp-server.mjs"
click node_native "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src-tauri/src/native_runtime.rs"
click node_tauri "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/platform/tauri-runtime.js"
click node_store "https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src-tauri/src/clipboard_history/store.rs"

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_lifecycle,node_user toneBlue
class node_pdfedit,node_pdftext,node_pdfai,node_pptdraft,node_pptimages,node_pptshared,node_markdown toneAmber
class node_image,node_audio,node_video,node_teleprompter,node_clipboard toneMint
class node_cli,node_registry,node_mcp toneRose
class node_native,node_tauri,node_store,node_ai toneIndigo
```

## Components

### App experience

- [Desktop workbench](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/app/app-composition.js): `toolknit-desktop/src/app/app-composition.js`
- [Tool lifecycle](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/app/tool-lifecycle.js): `toolknit-desktop/src/app/tool-lifecycle.js`

### Document workflows

- [PDF editor](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/pdf-editor/controller.js): `toolknit-desktop/src/features/pdf-editor/controller.js`
- [PDF text to Markdown](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/pdf-text-extract/controller.js): `toolknit-desktop/src/features/pdf-text-extract/controller.js`
- [AI PDF conversion](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/pdf-ai-markdown/pipeline.js): `toolknit-desktop/src/features/pdf-ai-markdown/pipeline.js`
- [PPT drafting](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/ppt-draft/controller.js): `toolknit-desktop/src/features/ppt-draft/controller.js`
- [PPT image workflow](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/ppt-images/controller.js): `toolknit-desktop/src/features/ppt-images/controller.js`
- [PPT workflow support](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/ppt-workflows/shared.js): `toolknit-desktop/src/features/ppt-workflows/shared.js`
- [Markdown editor](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/markdown-editor/controller.js): `toolknit-desktop/src/features/markdown-editor/controller.js`

### Media and utilities

- [Image tools](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/image-stitch/controller.js): `toolknit-desktop/src/features/image-stitch/controller.js`
- [Audio tools](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/audio-tools/clip-controller.js): `toolknit-desktop/src/features/audio-tools/clip-controller.js`
- [Video tools](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/video-tools/gif-controller.js): `toolknit-desktop/src/features/video-tools/gif-controller.js`
- [Teleprompter](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/teleprompter/controller.js): `toolknit-desktop/src/features/teleprompter/controller.js`
- [Clipboard history](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/features/clipboard-history/controller.js): `toolknit-desktop/src/features/clipboard-history/controller.js`

### CLI and agents

- [CLI entry](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/cli/toolknit.mjs): `toolknit-desktop/cli/toolknit.mjs`
- [Tool registry](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/cli/lib/tool-registry.mjs): `toolknit-desktop/cli/lib/tool-registry.mjs`
- [MCP server](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/cli/lib/mcp-server.mjs): `toolknit-desktop/cli/lib/mcp-server.mjs`

### Local platform

- [Native runtime](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src-tauri/src/native_runtime.rs): `toolknit-desktop/src-tauri/src/native_runtime.rs`
- [Tauri bridge](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src/platform/tauri-runtime.js): `toolknit-desktop/src/platform/tauri-runtime.js`
- [Clipboard store](https://github.com/zihangdong/toolknit-desktop/blob/main/toolknit-desktop/src-tauri/src/clipboard_history/store.rs): `toolknit-desktop/src-tauri/src/clipboard_history/store.rs`

### Other components

- **User**
- **Configured AI provider**

## Connections

- User → Desktop workbench: uses workbench (evidence: `README.md`)
- Desktop workbench → Tool lifecycle: manages tools
- Desktop workbench → PDF editor: opens tools
- Desktop workbench → PDF text to Markdown: opens tools
- Desktop workbench → AI PDF conversion: opens tools
- Desktop workbench → PPT drafting: opens tools
- Desktop workbench → PPT image workflow: opens tools
- Desktop workbench → Markdown editor: opens tools
- PDF editor → Tauri bridge: uses bridge (evidence: `toolknit-desktop/src/features/pdf-editor/controller.js`)
- PPT drafting → PPT workflow support: uses file helpers (evidence: `toolknit-desktop/src/features/ppt-draft/controller.js`)
- PPT image workflow → PPT workflow support: uses workflow helpers (evidence: `toolknit-desktop/src/features/ppt-images/controller.js`)
- AI PDF conversion → Configured AI provider: requests analysis (evidence: `toolknit-desktop/src/features/pdf-ai-markdown/pipeline.js`)
- User → CLI entry: runs commands (evidence: `README.md`)
- CLI entry → Tool registry: dispatches tools (evidence: `toolknit-desktop/cli/toolknit.mjs`)
- CLI entry → MCP server: starts server (evidence: `toolknit-desktop/cli/toolknit.mjs`)
- CLI entry → Configured AI provider: uses configured provider (evidence: `README.md`)
- Image tools → Tauri bridge: uses bridge (evidence: `toolknit-desktop/src/features/image-stitch/controller.js`)
- Audio tools → Tauri bridge: uses bridge (evidence: `toolknit-desktop/src/features/audio-tools/clip-controller.js`)
- Teleprompter → Tauri bridge: uses bridge (evidence: `toolknit-desktop/src/features/teleprompter/controller.js`)
- Clipboard history → Native runtime: records locally (evidence: `README.md`)
- Native runtime → Clipboard store: persists history
- PDF editor → Native runtime: uses local processing (evidence: `README.md`)
- PPT drafting → Native runtime: reads and writes files (evidence: `toolknit-desktop/src/features/ppt-draft/controller.js`)
- User → Image tools: uses image tools (evidence: `README.md`)
- User → Audio tools: uses media tools (evidence: `README.md`)
- User → Video tools: uses media tools (evidence: `README.md`)
- User → Teleprompter: uses presentation aid (evidence: `README.md`)
- User → Clipboard history: reviews copied items (evidence: `README.md`)
- PDF text to Markdown → Markdown editor: continues editing (evidence: `README.md`)
