Tasks
Tasks (also called cards) are the fundamental unit of work in barkcli. Each task is a YAML entry in a .board file.
Task Structure
| Field | Type | Description |
|---|---|---|
| id | string | Auto-generated from title |
| title | string | Human-readable task name |
| column | string | Current workflow stage |
| priority | enum | high, medium, low |
| description | string | Detailed task description |
| labels | string[] | Tags for categorization |
| assignee | string | Person responsible |
| due | date | Due date |
| effort | number | Story points or time estimate |
| checklist | array | Subtasks with completion status |
| comments | array | Discussion threads |
| links | array | Relationships to other tasks |
Creating Tasks
barkcli <board> add "Implement OAuth" \
--priority high \
--label backend \
--assignee alice \
--due 2025-02-01 \
--effort 5Task States
Tasks move through columns in your workflow:
todo → doing → review → done
Task Links
# Parent-child hierarchy
barkcli <board> link implement-auth auth-jwt --as parent
# Related tasks
barkcli <board> link login-bug oauth-fix --as related
# Blocked-by
barkcli <board> deploy-feature db-migration --as blocked-by
# View hierarchy
barkcli <board> treeYAML Format
id: implement-auth
title: Implement Google OAuth
column: doing
priority: high
labels:
- backend
- security
assignee: alice
due: 2025-02-01
effort: 5
checklist:
- text: Set up OAuth credentials
done: true
- text: Implement callback handler
done: false
links:
- type: parent
target: auth-system