How lugia19/claude-webextension-launcher works
This is a cross-platform Claude Desktop WebExtension installer and launcher. The main workflow checks the installed client and extensions, presents setup/checklist or instance selection, then launches Claude; when writes are needed, the launcher delegates installation and extension updates to a worker. Patching rebuilds the client from its package and modifies its ASAR resources. The README also documents self-updating, multi-instance management, shortcuts, session sharing, platform-specific Cowork/AppArmor setup, and uninstall. Several of those platform paths were not sampled, so their links are documented rather than inferred from imports.
Main entry points: main.go Launcher entry · worker.go Install worker · patcher.go Client patcher · extensions.go Extension updates
Components 25
Launcher and UI
- Launcher entry
main.go - Setup checklist
gui/checklist.go - Setup screen
gui/setup.go - Instance list
gui/instances.go - Instance management
instances.go - Launcher settings
utils/settings.go
Client patching
- Claude Desktop
- Client patcher
patcher/patcher.go - ASAR archive
asar/asar.go - Integrity shim
ClaudeDLL/ClaudeDLL/dllmain.cpp
Extensions
- Extension updates
extensions/extensions.go - Update recovery
extensions/recovery.go - Extension injection
resources/injections/generic/wrapper.js - Sentinel extension
resources/sentinel_extension/content.js
Install lifecycle
- Install worker
worker.go - Worker status
status/status.go - Self-update
selfupdate/selfupdate.go - Uninstall
uninstall.go - Shortcuts
shortcuts.go - Session sharing
sessionsharing_windows.go - Cowork service
patcher/cowork_windows.go - AppArmor profile
apparmor_linux.go
Other components
- Launcher user
- GitHub releases
- Claude package source
Connections 26
- Launcher user → Launcher entry: starts
- Launcher entry → Setup checklist: shows setup
- Launcher entry → Setup screen: runs UI
main.go - Launcher entry → Instance list: offers instances
- Instance list → Instance management: requests actions
- Instance management → Launcher settings: stores preferences
- Launcher entry → Self-update: finishes update
main.go - Launcher entry → Install worker: starts worker
main.go - Launcher entry → Worker status: reads progress
main.go - Install worker → Worker status: reports progress
worker.go - Install worker → Client patcher: installs client
worker.go - Client patcher → ASAR archive: extracts archive
patcher/patcher.go - Client patcher → Claude package source: downloads package
- Client patcher → Claude Desktop: builds modified client
- Integrity shim → Claude Desktop: adjusts integrity hash
ClaudeDLL/ClaudeDLL/dllmain.cpp - Install worker → Extension updates: updates extensions
worker.go - Extension updates → GitHub releases: checks releases
extensions/extensions.go - Extension updates → Update recovery: recovers updates
extensions/extensions.go - Install worker → Sentinel extension: deploys extension
worker.go - Client patcher → Extension injection: embeds injection
- Install worker → Cowork service: registers service
worker.go - Launcher entry → Uninstall: supports uninstall
- Launcher entry → Shortcuts: configures entries
- Uninstall → Session sharing: returns shared sessions
- Launcher entry → AppArmor profile: sets platform profile
- Launcher entry → Claude Desktop: launches instance