workstream

Attention management for makers. Track trains of thought across projects.

ws is a CLI tool for managing workstreams -- named trains of thought that span code repos, non-code activities, and time. Obsidian-native markdown files with YAML frontmatter, designed to be legible to both humans and LLMs.

Install

pipx install workstream-cli   # recommended
# or
pip install workstream-cli

For development:

pip install -e .

Quick Start

ws init                        # first-time setup
ws new "API Redesign"          # create a workstream
ws list                        # see all workstreams
ws next --tag code --size day  # what should I work on?
ws stale                       # what's gone cold?
ws sweep                       # scan repos for plan/branch updates
ws report --since 7d           # summarize recent work

Development

Running Tests

pytest                              # quick, no coverage
pytest --cov=workstream             # with coverage report
tox                                 # full matrix + combined coverage report
tox -e py311                        # single Python version
tox -e py311 -- -k test_models      # single env, filtered tests

Coverage Report

After running tox (which ends with coverage-report):

• Terminal summary prints automatically
• HTML report: open htmlcov/index.html

For a quick local coverage check without tox:

pytest --cov=workstream --cov-report=term-missing --cov-report=html
open htmlcov/index.html

License

MIT