bits
Track and manage work with bits task tracker. Use when user mentions "bits", "track issues", or needs dependencies between tasks.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Bits Task Tracking
When to Use
| Scenario | Tool |
|---|---|
| Multi-step work with dependencies | bits |
| Tasks that block other tasks | bits |
| Tracking progress across sessions | bits |
| Simple one-off checklist | TaskCreate |
| Quick session-scoped todos | TaskCreate |
Commands
| Task | Command |
|---|---|
| Find ready work | bits ready --json |
| Create task | bits add "Title" -d "Description" --json |
| Start work | bits claim <id> |
| Pause work | bits release <id> |
| Complete work | bits close <id> "reason" |
| View details | bits show <id> |
| List tasks | bits list |
Run bits --help for full reference.
Dependencies
bits add "Feature B" --json # Returns: bits-abc123
bits dep bits-abc123 bits-blocker # B blocked by blocker
Tasks with unresolved dependencies won't appear in bits ready.
Session Commands
| Command | Purpose |
|---|---|
bits session claim |
Claim primary session (reads stdin) |
bits session release |
Release session (reads stdin) |
bits session prune |
Manual cleanup of stale sessions |
bits session hook |
Stop hook with session ownership check |
Drain Commands
| Command | Purpose |
|---|---|
bits drain claim |
Activate drain mode (reads stdin) |
bits drain release |
Deactivate drain mode (reads stdin) |
Task Description Format
# Description
What and why.
# Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2
# Session Notes
[Date] COMPLETED: X | IN PROGRESS: Y | NEXT: Z
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!