How vinothus/pawwork-linux works
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: dsh Agent runtime · index.ts App coordinator · index.mjs Migration orchestration · dsh-sidecar.ts DSH sidecar
Components 22
Desktop shell
- App coordinator
packages/desktop-electron/src/main/index.ts - Native shell
packages/desktop-electron/src/main - App identity
packages/desktop-electron/src/main/app-identity.ts
Agent runtime
- DSH sidecar
packages/desktop-electron/src/main/dsh-sidecar.ts - Agent runtime
packages/desktop-electron/resources/dsh
Product services
- Free models
packages/desktop-electron/resources/dsh/product/lib/opencode-free.cjs - Web search
packages/desktop-electron/resources/dsh/web-search/lib/index.js - Exa search adapter
packages/desktop-electron/resources/dsh/web-search/lib/exa-mcp.js - Automations
packages/desktop-electron/resources/dsh/automations/lib/automations.cjs - Cron scheduling
packages/desktop-electron/resources/dsh/automations/lib/automation-cron.cjs - V1 migration
packages/desktop-electron/resources/dsh/home/plugins/import-v1/import-v1.cjs - Migration snapshots
packages/desktop-electron/resources/dsh/home/plugins/import-v1/migration-io.cjs - Migration orchestration
packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs
Office skills
- Word skills
skills/office-docx - Spreadsheet skills
skills/office-xlsx - PowerPoint conversion
skills/office-pptx/scripts/svg_to_pptx/pptx_package/builder.py - Chart XML
skills/office-pptx/scripts/svg_to_pptx/native_objects/chart_xml.py - PDF skills
skills/office-pdf
Updates
- Auto-updater
packages/desktop-electron/src/main/updater.ts - Update feed
packages/desktop-electron/src/main/update-feed.ts
Other components
- Knowledge worker
- Workspace files
Connections 21
- Knowledge worker → App coordinator: requests work
README.md - App coordinator → Native shell: presents interface
README.md - App coordinator → DSH sidecar: starts runtime
packages/desktop-electron/src/main/index.ts - DSH sidecar → Agent runtime: hosts runtime
README.md - Agent runtime → Workspace files: works with files
README.md - Agent runtime → Free models: routes model requests
README.md - Agent runtime → Web search: uses search
README.md - Web search → Exa search adapter: dispatches Exa
packages/desktop-electron/resources/dsh/web-search/lib/index.js - Agent runtime → Automations: runs scheduled tasks
README.md - Automations → Cron scheduling: checks schedules
packages/desktop-electron/resources/dsh/automations/lib/automations.cjs - Agent runtime → Word skills: uses skills
README.md - Agent runtime → Spreadsheet skills: uses skills
README.md - Agent runtime → PowerPoint conversion: uses skills
README.md - Agent runtime → PDF skills: uses skills
README.md - PowerPoint conversion → Chart XML: emits chart XML
skills/office-pptx/scripts/svg_to_pptx/pptx_package/builder.py - App coordinator → Migration orchestration: runs migration
packages/desktop-electron/src/main/index.ts - Migration orchestration → V1 migration: imports sessions
packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs - Migration orchestration → Migration snapshots: opens snapshots
packages/desktop-electron/resources/dsh/home/plugins/import-v1/index.mjs - App coordinator → Auto-updater: manages updates
README.md - Auto-updater → Update feed: checks update feed
- App coordinator → App identity: uses identity
packages/desktop-electron/src/main/index.ts