Boards

Board Structure

.board/
├── config.json          # Project configuration
├── my-project.board     # Board file
├── backend.board        # Another board
├── history/             # Operation history
├── sessions/            # Agent sessions
├── snapshots/           # Checkpoints
├── context/             # Code context mappings
└── sprints/             # Sprint data

Creating Boards

# Create with default columns
barkcli create my-project

# List all boards
barkcli boards

Board File Format

columns:
  - id: todo
    name: Todo
  - id: doing
    name: Doing
  - id: review
    name: Review
  - id: done
    name: Done
cards:
  - id: implement-auth
    title: Implement Google OAuth
    column: doing
    priority: high
    labels:
      - backend
    assignee: alice

Board Configuration

Configure in .board/config.json:

{
  "default_board": "my-project",
  "columns": [
    { "id": "todo", "name": "Todo" },
    { "id": "doing", "name": "Doing" },
    { "id": "review", "name": "Review" },
    { "id": "done", "name": "Done" }
  ]
}

Multiple Boards

Use multiple boards for different contexts:

barkcli create frontend
barkcli create backend
barkcli create devops

# Work on specific board
barkcli frontend add "Fix CSS layout"
barkcli backend add "Optimize queries"

Git Integration

Board files are committed to git:

# See what changed
barkcli my-project log

# Diff against git ref
barkcli my-project diff main

# Undo last change
barkcli my-project undo