How jackiezheng/xueren-workbuddy-live-progress works
This repository is a WorkBuddy task-progress skill: hooks turn prompts and tool activity into task cards, optional reporting paths update their progress, and a local panel displays current and finished work. The main path is prompt/session activity → shared job registry → browser panel, with separate handling for background tasks, explicit script reporting, and bridged external progress. The graph also includes documented hook installation and self-update capabilities. Some links rely on README statements or SOURCE INDEX references; unsampled implementation details are not inferred.
Main entry points: progress.py Job registry · live_panel.py HTTP panel and UI · check_update.py Skill updater · hook_session.py Session hook
Components 18
WorkBuddy hooks
- Hook installer
scripts/install_hooks.py - Prompt hook
scripts/hook_prompt.py - Session hook
scripts/hook_session.py - Tool step hook
scripts/hook_auto_step.py - Background hook
scripts/hook_bg.py - Stop hook
scripts/hook_stop.py
Progress tracking
- Job registry
scripts/progress.py - jobs.json
- Progress bridge
scripts/progress_bridge.py
Live panel
- HTTP panel and UI
scripts/live_panel.py
Panel operations
- Panel controller
scripts/panel_ctl.py
Skill updates
- Skill updater
scripts/check_update.py - Update backups
cache/backups
Other components
- WorkBuddy user
- WorkBuddy runtime
- Browser viewer
- External state files
- Release sources
Connections 23
- WorkBuddy user → WorkBuddy runtime: submits prompt
README.md - Hook installer → WorkBuddy runtime: configures hooks
README.md - WorkBuddy runtime → Prompt hook: dispatches prompt
README.md - WorkBuddy runtime → Session hook: dispatches session
README.md - WorkBuddy runtime → Tool step hook: dispatches tools
README.md - WorkBuddy runtime → Background hook: dispatches background
README.md - WorkBuddy runtime → Stop hook: dispatches stop
scripts/hook_stop.py - Prompt hook → Job registry: registers session
scripts/hook_prompt.py - Session hook → Job registry: prunes and recovers
scripts/hook_session.py - Session hook → Background hook: reuses panel startup
scripts/hook_session.py - Tool step hook → Job registry: records tool steps
scripts/hook_auto_step.py - Background hook → Job registry: tracks background jobs
scripts/hook_bg.py - Stop hook → Job registry: finishes session jobs
scripts/hook_stop.py - Progress bridge → External state files: reads progress
scripts/progress_bridge.py - Progress bridge → Job registry: reports progress
scripts/progress_bridge.py - Job registry → jobs.json: reads and writes
README.md - HTTP panel and UI → Job registry: reads jobs
scripts/live_panel.py - Browser viewer → HTTP panel and UI: polls APIs
README.md - HTTP panel and UI → Browser viewer: serves dashboard
README.md - Panel controller → HTTP panel and UI: starts and controls
README.md - Skill updater → Release sources: checks and downloads
README.md - Skill updater → Update backups: backs up package
README.md - Skill updater → Panel controller: coordinates upgrade
scripts/check_update.py