tb-taskboard 0.3.1

TB — Task Board CLI for managing flat-file YAML tasks synced via git

tb-taskboard

tb — a Python CLI for managing the taskboard flat-file Kanban board. Every mutation is a git mv + auto-commit + auto-push, so state stays coherent across machines.

The PyPI package is tb-taskboard; the installed command is tb. (The git repo is still IamMaikPeters/tb-cli.)

Install

pipx install tb-taskboard

# Join an existing board (any git remote):
tb init --repo [e-mail]:you/your-taskboard.git

# …or scaffold a fresh board locally:
tb init --new

tb init --new creates the column directories, a starter config.yaml, the task-ID counter, and an initial git commit; add a remote afterwards to sync the board across machines.

For local development against a checkout:

pipx install -e /path/to/tb-cli

Usage (planned — Wave 2+)

tb new "wire signed approval link" --project webapp
tb start TB-0042
tb done TB-0042 --note "shipped in v0.4"
tb list --project webapp
tb sync

The auto-commit format is machine-parseable: tb: TB-NNNN <from-column> → <to-column>. Don't change it without updating downstream parsers (e.g. the tb-mac git log reader).

Development

pip install -e ".[dev]"
ruff check
mypy --strict src
pytest -q

Related repos

• IamMaikPeters/taskboard — task data, single source of truth
• IamMaikPeters/tb-mac — macOS native app (Phase 2+)

License

MIT — see LICENSE.