konban

Konban — Personal Kanban via Notion API

Overview

Claude skill for reading and managing a personal Kanban board ("Konban") in Notion. Used during daily standups and ad-hoc task management.

Helper Script

All operations go through the helper script (avoids shell quoting issues with curl + Bearer tokens):

python3 <skill-dir>/konban/notion-api.py <command> [args]

Commands

# Read active board (standup view — excludes Done/Grave)
python3 <script> board

# Read all items including Done/Grave
python3 <script> all

# Search tasks by keyword (active only — excludes Done/Grave)
python3 <script> search "QA tester"

# Create a task (ALWAYS search first — see Deduplication below)
python3 <script> create "Task name" \
  --priority High --timebox "1 h" --due 2026-02-20

# Update a task (any combination of flags)
python3 <script> update PAGE_ID \
# update accepts: page_id (positional), --name, --status, --priority, --timebox, --due
  --status "Doing ⚡️" --priority High

# Log progress on a task (appends timestamped note to page body)
python3 <script> log PAGE_ID "Sent proposal, awaiting response"

# Read task history (all log entries on a page)
python3 <script> history PAGE_ID

# Mark done
python3 <script> done PAGE_ID

# Trash a task
python3 <script> trash PAGE_ID

What create Does NOT Support

create only accepts --priority, --timebox, and --due. There are no --description, --domain, --tag, or --estimate flags. To add context to a new task, create it first then log:

# WRONG: create "Task" --description "Details" --domain KH --tag feature
# RIGHT:
python3 <script> create "Task" --priority High
python3 <script> log PAGE_ID "Details and context here"

When a task has associated content (draft text, a plan, deliverable outline), log it immediately after creation. The task body is the working surface — future sessions should find the content there, not have to reconstruct it:

# Create task, then log the deliverable content into the body
python3 <script> create "Write blog post about X" --priority Medium --due 2026-03-02
python3 <script> log PAGE_ID "DRAFT:\n\nHey everyone, I built a thing..."