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 initCreates .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 pushEnvironment Variables
| Variable | Description |
|---|---|
| BARKCLI_BOARD | Default board name |
| BARKCLI_TOKEN | API authentication token |
| OPENAI_API_KEY | OpenAI API key (for AI features) |
| ANTHROPIC_API_KEY | Anthropic API key (for AI features) |