# vinothus/pawwork-linux architecture

> Architecture diagram of the GitHub repository vinothus/pawwork-linux, 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/vinothus/pawwork-linux
- Repository: https://github.com/vinothus/pawwork-linux

## Overview

PawWork is a native desktop AI agent for knowledge workers. The user chooses a workspace and describes a task; PawWork’s Electron shell starts the DSH runtime, which works with local files, models, search, and bundled Office skills to produce reviewable results. Major product branches include scheduled automations, legacy-data migration, and updating. The README documents the product-level workflow and capabilities; source excerpts are partial, so detailed links within unsampled subsystems are omitted.

Main entry points: [`packages/desktop-electron/resources/dsh`](https://github.com/vinothus/pawwork-linux/tree/linux-support/packages/desktop-electron/resources/dsh) (Agent runtime), [`packages/desktop-electron/src/main/index.ts`](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/index.ts) (App coordinator), [`packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs`](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs) (Migration orchestration), [`packages/desktop-electron/src/main/dsh-sidecar.ts`](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/dsh-sidecar.ts) (DSH sidecar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop shell"]
  node_main["App coordinator<br/>[index.ts]"]
  node_native["Native shell"]
  node_identity["App identity<br/>[app-identity.ts]"]
end

subgraph group_runtime["Agent runtime"]
  node_sidecar["DSH sidecar<br/>[dsh-sidecar.ts]"]
  node_agent["Agent runtime"]
end

subgraph group_product["Product services"]
  node_models["Free models<br/>[opencode-free.cjs]"]
  node_search["Web search<br/>[index.js]"]
  node_exa["Exa search adapter<br/>[exa-mcp.js]"]
  node_automation["Automations<br/>[automations.cjs]"]
  node_cron["Cron scheduling"]
  node_migration["V1 migration<br/>[import-v1.cjs]"]
  node_migration_io["Migration snapshots<br/>[migration-io.cjs]"]
  node_migration_entry["Migration orchestration<br/>[index.mjs]"]
end

subgraph group_skills["Office skills"]
  node_docx["Word skills"]
  node_xlsx["Spreadsheet skills"]
  node_pptx["PowerPoint conversion<br/>[builder.py]"]
  node_pptx_charts["Chart XML<br/>[chart_xml.py]"]
  node_pdf["PDF skills"]
end

subgraph group_updates["Updates"]
  node_updater["Auto-updater<br/>[updater.ts]"]
  node_release_feed["Update feed<br/>[update-feed.ts]"]
end

node_user(("Knowledge worker"))
node_workspace[("Workspace files")]

node_user -->|"requests work"| node_main
node_main -->|"presents interface"| node_native
node_main -->|"starts runtime"| node_sidecar
node_sidecar -->|"hosts runtime"| node_agent
node_agent -->|"works with files"| node_workspace
node_agent -->|"routes model requests"| node_models
node_agent -->|"uses search"| node_search
node_search -->|"dispatches Exa"| node_exa
node_agent -->|"runs scheduled tasks"| node_automation
node_automation -->|"checks schedules"| node_cron
node_agent -->|"uses skills"| node_docx
node_agent -->|"uses skills"| node_xlsx
node_agent -->|"uses skills"| node_pptx
node_agent -->|"uses skills"| node_pdf
node_pptx -->|"emits chart XML"| node_pptx_charts
node_main -->|"runs migration"| node_migration_entry
node_migration_entry -->|"imports sessions"| node_migration
node_migration_entry -->|"opens snapshots"| node_migration_io
node_main -->|"manages updates"| node_updater
node_updater -.->|"checks update feed"| node_release_feed
node_main -->|"uses identity"| node_identity

click node_main "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/index.ts"
click node_native "https://github.com/vinothus/pawwork-linux/tree/linux-support/packages/desktop-electron/src/main"
click node_sidecar "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/dsh-sidecar.ts"
click node_agent "https://github.com/vinothus/pawwork-linux/tree/linux-support/packages/desktop-electron/resources/dsh"
click node_models "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/product/lib/opencode-free.cjs"
click node_search "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/web-search/lib/index.js"
click node_exa "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/web-search/lib/exa-mcp.js"
click node_automation "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/automations/lib/automations.cjs"
click node_cron "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/automations/lib/automation-cron.cjs"
click node_migration "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/home/plugins/import-v1/import-v1.cjs"
click node_migration_io "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/home/plugins/import-v1/migration-io.cjs"
click node_migration_entry "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs"
click node_docx "https://github.com/vinothus/pawwork-linux/tree/linux-support/skills/office-docx"
click node_xlsx "https://github.com/vinothus/pawwork-linux/tree/linux-support/skills/office-xlsx"
click node_pptx "https://github.com/vinothus/pawwork-linux/blob/linux-support/skills/office-pptx/scripts/svg_to_pptx/pptx_package/builder.py"
click node_pptx_charts "https://github.com/vinothus/pawwork-linux/blob/linux-support/skills/office-pptx/scripts/svg_to_pptx/native_objects/chart_xml.py"
click node_pdf "https://github.com/vinothus/pawwork-linux/tree/linux-support/skills/office-pdf"
click node_updater "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/updater.ts"
click node_identity "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/app-identity.ts"
click node_release_feed "https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/update-feed.ts"

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_main,node_native,node_identity toneBlue
class node_sidecar,node_agent,node_workspace toneAmber
class node_models,node_search,node_exa,node_automation,node_cron,node_migration,node_migration_io,node_migration_entry toneMint
class node_docx,node_xlsx,node_pptx,node_pptx_charts,node_pdf,node_user toneRose
class node_updater,node_release_feed toneIndigo
```

## Components

### Desktop shell

- [App coordinator](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/index.ts): `packages/desktop-electron/src/main/index.ts`
- [Native shell](https://github.com/vinothus/pawwork-linux/tree/linux-support/packages/desktop-electron/src/main): `packages/desktop-electron/src/main`
- [App identity](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/app-identity.ts): `packages/desktop-electron/src/main/app-identity.ts`

### Agent runtime

- [DSH sidecar](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/dsh-sidecar.ts): `packages/desktop-electron/src/main/dsh-sidecar.ts`
- [Agent runtime](https://github.com/vinothus/pawwork-linux/tree/linux-support/packages/desktop-electron/resources/dsh): `packages/desktop-electron/resources/dsh`

### Product services

- [Free models](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/product/lib/opencode-free.cjs): `packages/desktop-electron/resources/dsh/product/lib/opencode-free.cjs`
- [Web search](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/web-search/lib/index.js): `packages/desktop-electron/resources/dsh/web-search/lib/index.js`
- [Exa search adapter](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/web-search/lib/exa-mcp.js): `packages/desktop-electron/resources/dsh/web-search/lib/exa-mcp.js`
- [Automations](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/automations/lib/automations.cjs): `packages/desktop-electron/resources/dsh/automations/lib/automations.cjs`
- [Cron scheduling](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/automations/lib/automation-cron.cjs): `packages/desktop-electron/resources/dsh/automations/lib/automation-cron.cjs`
- [V1 migration](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/home/plugins/import-v1/import-v1.cjs): `packages/desktop-electron/resources/dsh/home/plugins/import-v1/import-v1.cjs`
- [Migration snapshots](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/home/plugins/import-v1/migration-io.cjs): `packages/desktop-electron/resources/dsh/home/plugins/import-v1/migration-io.cjs`
- [Migration orchestration](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs): `packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs`

### Office skills

- [Word skills](https://github.com/vinothus/pawwork-linux/tree/linux-support/skills/office-docx): `skills/office-docx`
- [Spreadsheet skills](https://github.com/vinothus/pawwork-linux/tree/linux-support/skills/office-xlsx): `skills/office-xlsx`
- [PowerPoint conversion](https://github.com/vinothus/pawwork-linux/blob/linux-support/skills/office-pptx/scripts/svg_to_pptx/pptx_package/builder.py): `skills/office-pptx/scripts/svg_to_pptx/pptx_package/builder.py`
- [Chart XML](https://github.com/vinothus/pawwork-linux/blob/linux-support/skills/office-pptx/scripts/svg_to_pptx/native_objects/chart_xml.py): `skills/office-pptx/scripts/svg_to_pptx/native_objects/chart_xml.py`
- [PDF skills](https://github.com/vinothus/pawwork-linux/tree/linux-support/skills/office-pdf): `skills/office-pdf`

### Updates

- [Auto-updater](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/updater.ts): `packages/desktop-electron/src/main/updater.ts`
- [Update feed](https://github.com/vinothus/pawwork-linux/blob/linux-support/packages/desktop-electron/src/main/update-feed.ts): `packages/desktop-electron/src/main/update-feed.ts`

### Other components

- **Knowledge worker**
- **Workspace files**

## Connections

- Knowledge worker → App coordinator: requests work (evidence: `README.md`)
- App coordinator → Native shell: presents interface (evidence: `README.md`)
- App coordinator → DSH sidecar: starts runtime (evidence: `packages/desktop-electron/src/main/index.ts`)
- DSH sidecar → Agent runtime: hosts runtime (evidence: `README.md`)
- Agent runtime → Workspace files: works with files (evidence: `README.md`)
- Agent runtime → Free models: routes model requests (evidence: `README.md`)
- Agent runtime → Web search: uses search (evidence: `README.md`)
- Web search → Exa search adapter: dispatches Exa (evidence: `packages/desktop-electron/resources/dsh/web-search/lib/index.js`)
- Agent runtime → Automations: runs scheduled tasks (evidence: `README.md`)
- Automations → Cron scheduling: checks schedules (evidence: `packages/desktop-electron/resources/dsh/automations/lib/automations.cjs`)
- Agent runtime → Word skills: uses skills (evidence: `README.md`)
- Agent runtime → Spreadsheet skills: uses skills (evidence: `README.md`)
- Agent runtime → PowerPoint conversion: uses skills (evidence: `README.md`)
- Agent runtime → PDF skills: uses skills (evidence: `README.md`)
- PowerPoint conversion → Chart XML: emits chart XML (evidence: `skills/office-pptx/scripts/svg_to_pptx/pptx_package/builder.py`)
- App coordinator → Migration orchestration: runs migration (evidence: `packages/desktop-electron/src/main/index.ts`)
- Migration orchestration → V1 migration: imports sessions (evidence: `packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs`)
- Migration orchestration → Migration snapshots: opens snapshots (evidence: `packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs`)
- App coordinator → Auto-updater: manages updates (evidence: `README.md`)
- Auto-updater → Update feed: checks update feed
- App coordinator → App identity: uses identity (evidence: `packages/desktop-electron/src/main/index.ts`)
