Projects

A project is any codebase that contains a .board/ directory. barkcli works in any git repository.

Project Structure

my-project/
├── .board/              # barkcli metadata (gitignored)
│   ├── config.json
│   ├── *.board          # Board files
│   ├── history/
│   ├── sessions/
│   ├── snapshots/
│   ├── context/
│   └── sprints/
├── src/                 # Your source code
├── package.json
└── .git/

Initializing a Project

# In your project root
barkcli init

Creates .board/ directory, config.json, and .gitignore entries.

Team Workflow

# Team member 1
barkcli init
barkcli create sprint-1
barkcli sprint-1 add "Feature A" -p high
git add .board
git commit -m "Add sprint-1 board"
git push

# Team member 2
git pull
barkcli sprint-1 list
barkcli sprint-1 move feature-a doing
git add .board
git commit -m "Move Feature A to doing"
git push

Environment Variables

VariableDescription
BARKCLI_BOARDDefault board name
BARKCLI_TOKENAPI authentication token
OPENAI_API_KEYOpenAI API key (for AI features)
ANTHROPIC_API_KEYAnthropic API key (for AI features)