---

name: ba description: Task tracking. "$ba status" for current tasks, "$ba claim " to start work, "$ba finish " when done.

ba - Task Tracking for AI Sessions

Simple, file-based task tracking. No server, no database - just files in .ba/.

All commands invoke the ba CLI. If ba is not installed, show:

Copyba not installed. Install with:
  brew tap open-horizon-labs/homebrew-tap && brew install ba
  # or: cargo install ba

$ba status

Show current task status - what's ready, what's claimed, what's blocked.

Copyba ready && echo "" && ba mine && echo "" && ba list --status open

$ba init

Initialize task tracking for this project.

Copyba init

$ba claim

Claim a task to start working on it.

Copyba claim <id>

$ba finish

Mark a task as complete (releases claim and closes).

Copyba finish <id>

$ba create

Create a new task.

Copyba create "<title>"

$ba ready

Show tasks that are ready to work on (open and not blocked).

Copyba ready

$ba list

List all tasks with optional filters.

Copyba list                    # All tasks
ba list --status open      # Open tasks only
ba list --status closed    # Closed tasks only
ba list --label <label>    # Tasks with specific label

$ba show

Show details of a specific task including comments and blocking relationships.

Copyba show <id>

$ba block

Mark that task is blocked by task .

Copyba block <id> <blocker>

$ba unblock

Remove a blocking relationship.

Copyba unblock <id> <blocker>

$ba comment

Add a comment to a task.

Copyba comment <id> "<comment>"

$ba tree

Show the dependency tree of all tasks.

Copyba tree

$ba quickstart

Show the quick start guide for using ba.

Copyba quickstart

---

Workflow

Typical task workflow:

1. Check what's ready: $ba status or $ba ready
2. Claim a task: $ba claim <id>
3. Do the work
4. Add comments if needed: ba comment <id> "progress note"
5. Finish when done: $ba finish <id>

Protocol: Always track non-trivial work. If a task has multiple steps or will take >5 minutes, create a task.