How mindedtech/busy-octopus works
Busy Octopus is a VS Code extension and companion CLI/library for routing agent, command, or direct notifications to the matching workspace. The main path resolves workspace identity, publishes a validated request to a filesystem queue, then the extension consumes it and dispatches to enabled editor or Windows channels. Agent setup and command wrapping are separate CLI capabilities. Queue and dispatcher wiring is supported by sampled source; CLI command details and several extension subsystems are represented from the tree and README, so uncertain internal calls are omitted.
Main entry points: resolution.ts Workspace resolution · dispatcher.ts Delivery dispatcher · run.ts Command wrapper · notify.ts Notification API
Components 26
CLI & Agents
- CLI commands
src/cli/cli.ts - CLI entry
src/cli/main.ts - Command wrapper
src/cli/run.ts - Agent commands
src/cli/agent.ts - Hook & skill setup
src/integration/agent/setup.ts - Provider adapters
src/integration/agent/provider.ts - Notification API
src/library/notify.ts - Direct notify
src/cli/notify.ts
Workspace & Protocol
- Workspace resolution
src/workspace/resolution.ts - Workspace identity
src/workspace/identity.ts - Request protocol
src/protocol/notification.ts
Queue Transport
- Queue coordinator
src/queue/queue.ts - Queue location
src/workspace/queue.ts - Native queue FS
src/queue/file-system.ts
VS Code Delivery
- Extension activation
src/extension/extension.ts - Workspace consumer
src/extension/workspace-consumer.ts - Queue consumer
src/extension/queue/consumer.ts - VS Code queue FS
src/extension/queue/file-system.ts - Delivery dispatcher
src/extension/delivery/dispatcher.ts - Editor notifications
src/extension/delivery/adapter/editor.ts - Windows notifications
src/extension/delivery/adapter/windows/notification.ts - Taskbar flash
src/extension/delivery/adapter/windows/taskbar.ts - Windows bridge
src/extension/windows/bridge.ts
Other components
- User or agent
- VS Code host
- Windows PowerShell
Connections 35
- User or agent → CLI entry: runs CLI
- CLI entry → CLI commands: starts program
- CLI commands → Command wrapper: dispatches
- CLI commands → Agent commands: dispatches
- Agent commands → Hook & skill setup: configures
- Hook & skill setup → Provider adapters: selects adapter
- Hook & skill setup → Workspace resolution: resolves directory
- User or agent → Notification API: calls API
- User or agent → Direct notify: runs notify
- Direct notify → Workspace resolution: selects workspace
- Notification API → Workspace resolution: resolves directory
- Workspace resolution → Workspace identity: identifies workspace
- Workspace resolution → Request protocol: creates context
- Command wrapper → Workspace resolution: resolves workspace
- Command wrapper → Request protocol: creates request
- Direct notify → Request protocol: creates request
- Notification API → Request protocol: creates request
- Command wrapper → Queue location: locates queue
- Direct notify → Queue location: locates queue
- Notification API → Queue location: locates queue
- Queue location → Queue coordinator: publishes request
- Queue coordinator → Native queue FS: writes request
- VS Code host → Extension activation: activates
- Extension activation → Workspace consumer: starts consumption
- Workspace consumer → Queue consumer: creates consumers
- Queue consumer → Queue coordinator: claims request
- Queue coordinator → VS Code queue FS: reads queue
- Extension activation → Delivery dispatcher: delivers test request
- Queue consumer → Delivery dispatcher: dispatches request
- Delivery dispatcher → Editor notifications: sends notification
- Delivery dispatcher → Windows notifications: sends notification
- Delivery dispatcher → Taskbar flash: flashes taskbar
- Windows notifications → Windows bridge: invokes native operation
- Taskbar flash → Windows bridge: controls flash
- Windows bridge → Windows PowerShell: runs scripts