Files

Calmcacil 26120b8bc2 Add WireGuard TUI implementation

- Add Go TUI with bubbletea for WireGuard management
- Implement client CRUD operations with QR code generation
- Add configuration and validation modules
- Install/update scripts for client setup
- Update Makefile to build binaries to bin/ directory
- Add .gitignore for Go projects

2026-01-12 19:03:35 +01:00

2.8 KiB

Raw Blame History

Beads Workflow Guide

Quick Start

bd ready              # Find available work
bd show <id>          # View issue details
bd update <id> --status in_progress  # Claim work
bd close <id>         # Complete work
bd sync               # Sync with git

Workflow Commands

Finding Work

bd ready - Show issues ready to work (no blockers)
bd list --status=open - All open issues
bd list --status=in_progress - Your active work
bd show <id> - Detailed issue view with dependencies

Creating & Updating

bd create --title="..." --type=task|bug|feature --priority=2 - New issue
- Priority: 0-4 or P0-P4 (0=critical, 2=medium, 4=backlog). NOT "high"/"medium"/"low"
bd update <id> --status=in_progress - Claim work
bd update <id> --assignee=username - Assign to someone
bd close <id> - Mark complete
bd close <id1> <id2> ... - Close multiple issues at once (more efficient)
bd close <id> --reason="explanation" - Close with reason
Tip: When creating multiple issues/tasks/epics, use parallel subagents for efficiency

Dependencies & Blocking

bd dep add <issue> <depends-on> - Add dependency (issue depends on depends-on)
bd blocked - Show all blocked issues
bd show <id> - See what's blocking/blocked by this issue

Sync & Collaboration

bd sync - Sync with git remote (run at session end)
bd sync --status - Check sync status without syncing

Project Health

bd stats - Project statistics (open/closed/blocked counts)
bd doctor - Check for issues (sync problems, missing hooks)

Common Workflows

Starting Work

bd ready           # Find available work
bd show <id>       # Review issue details
bd update <id> --status=in_progress  # Claim it

Completing Work

bd close <id1> <id2> ...    # Close all completed issues at once
bd sync                     # Push to remote

Creating Dependent Work

# Run bd create commands in parallel (use subagents for many items)
bd create --title="Implement feature X" --type=feature
bd create --title="Write tests for X" --type=task
bd dep add beads-yyy beads-xxx  # Tests depend on Feature (Feature blocks tests)

Integration with Gitea

When working on Gitea issues:

Create a beads issue to track the work
Link to Gitea issue in description or comments
When committing, use Closes #{gitea_number} to auto-close
Close the beads issue after push succeeds

Session Close Protocol

CRITICAL: Before saying "done", run this checklist:

[ ] 1. git status              (check what changed)
[ ] 2. git add <files>         (stage code changes)
[ ] 3. bd sync                 (commit beads changes)
[ ] 4. git commit -m "..."     (commit code)
[ ] 5. bd sync                 (commit any new beads changes)
[ ] 6. git push                (push to remote)

Work is NOT complete until git push succeeds.

2.8 KiB Raw Blame History