How w3dev33/beads-task-issue-tracker works
Beads Task-Issue Tracker is a desktop human control panel for issues managed by the br or bd CLI. Users select a project, inspect dashboard and filtered issue lists, then view or edit issues, comments, and relationships; changes made externally are reflected in the app. The README also describes attachments, project favorites, themes, repair, and live updates. The graph combines documented capabilities with sampled entry-point and storage code; several feature-to-API details are unsampled, so uncertain wiring is omitted.
Main entry points: index.vue App workspace · IssuePreview.vue Issue preview · bd-api.ts CLI API client · list.get.ts Issue API routes
Components 23
App experience
- App workspace
app/pages/index.vue - App shell
app/app.vue - Dashboard
app/components/dashboard/DashboardContent.vue
Issue workflow
- Issue list
app/components/issues/IssueListPanel.vue - Issue preview
app/components/details/IssuePreview.vue - Issue editing
app/components/details/IssueForm.vue - Comments
app/components/details/CommentSection.vue - Attachments
app/composables/useAttachments.ts - Markdown viewer
app/composables/useMarkdownPreview.ts - Issue data
app/types/issue.ts - Issue operations
app/composables/useIssues.ts - Markdown preview UI
app/components/ui/markdown-preview/MarkdownPreviewDialog.vue
CLI integration
- CLI API client
app/utils/bd-api.ts - Issue API routes
server/api/bd/list.get.ts - CLI executor
server/utils/bd-executor.ts - Issue transformers
server/utils/bd-transformers.ts
Project state
- Project selection
app/composables/useBeadsPath.ts - Project settings
app/composables/useProjectStorage.ts
Desktop services
- Change detection
app/composables/useChangeDetection.ts - Tauri runtime
src-tauri/src/lib.rs
Other components
- Human user
- br / bd CLI
- Beads project files
Connections 24
- Human user → App workspace: uses workspace
- App workspace → Dashboard: shows dashboard
- App workspace → Issue list: shows issues
- App workspace → Issue preview: previews selection
- Issue list → Issue operations: requests issue data
- Issue preview → Issue editing: opens editing
- Issue preview → Comments: manages comments
- Issue preview → Attachments: manages attachments
- Attachments → Markdown viewer: opens markdown
- Markdown viewer → Markdown preview UI: renders and edits
- Issue operations → CLI API client: calls issue operations
- CLI API client → Issue API routes: requests API
- Issue API routes → CLI executor: executes CLI
- CLI executor → br / bd CLI: invokes
- br / bd CLI → Beads project files: reads and writes
- Issue transformers → Issue API routes: transforms issue data
- Project selection → CLI API client: supplies project path
- Project selection → Project settings: namespaces settings
- Project settings → Human user: persists preferences
- Beads project files → Tauri runtime: watches changes
- Tauri runtime → Change detection: emits change events
- Change detection → App workspace: refreshes issue data
- App shell → App workspace: hosts page
- App workspace → Issue data: holds issue state