Advanced Features

Sessions, checkpoints, sprints, and hooks.

Sessions

barkcli captures agent sessions — when you or an AI agent works on a task, the session is recorded.

What's Captured

  • Prompt — What you asked the agent
  • Files touched — Which files were modified
  • Commit — The git commit created
  • Duration — How long the session took
  • Matched cards — Which tasks were affected
barkcli session list              # show captured sessions
barkcli session show session-abc  # full session detail
barkcli session resume session-abc # print context for agent

Checkpoints

Checkpoints save your board state at a point in time. You can restore to any checkpoint.

Types

  • Manual — You save explicitly
  • Auto — Created automatically when git commits touch .board files
barkcli checkpoint list           # list checkpoints
barkcli checkpoint save "before refactor" # save checkpoint
barkcli checkpoint restore checkpoint-abc # restore

Hooks

Hooks let barkcli integrate with your coding agent (opencode, claude-code, etc.).

barkcli hooks install             # install for all agents
barkcli hooks install --agent opencode # specific agent
barkcli hooks status              # show installed hooks

What Hooks Do

  • Post-session — Record the agent session automatically
  • Post-commit — Save a checkpoint if .board files changed

Sprints

Sprints let you group tasks into time-boxed iterations.

barkcli sprint start "Sprint 1" --ends 2024-12-31
barkcli sprint end "Sprint 1"
barkcli sprint list

MCP Server

barkcli includes an MCP server for coding agent integration via JSON-RPC 2.0 over stdio.

barkcli mcp  # Start MCP server

# Exposes 25+ tools:
# - board_list, card_list, card_create, card_update
# - code_search, callgraph_get, metrics_get
# - task_create, task_assign, task_complete
# - agent_register, orchestrate_next

Pro Features

Advanced features requiring a license.

AI Task Breakdown

barkcli ai "Break down the authentication feature"

Reporting

barkcli report                    # weekly report
barkcli report --sprint "Sprint 1"  # sprint burndown
barkcli changelog                 # auto-generate from git
barkcli stats                     # progress analytics

Templates

barkcli template list
barkcli template install feature

GitHub Sync

barkcli sync --push    # push to GitHub Issues
barkcli sync --pull    # pull from GitHub Issues

File Structure

.board/
├── config.json          # Board configuration
├── main.board           # Your tasks (YAML)
├── history/
│   └── main.log         # Change history (JSONL)
├── sessions/
│   └── main.jsonl       # Agent sessions
├── snapshots/
│   ├── manual/          # Manual checkpoints
│   └── auto/            # Auto-checkpoints
├── context/
│   └── main.json        # Code context
├── sprints/
│   └── main.json        # Sprint metadata
└── .gitignore           # Ignores everything except *.board