Yaks — Task tracking workflow

This project tracks work with Yaks. Tasks are markdown files with YAML frontmatter in .yaks/. You MUST follow this workflow to keep task state accurate.

Running yaks

Yaks is a plain command-line tool. Run it directly from your shell — there are no slash commands. Use the first invocation that works in your environment:

1. yaks <cmd> — if yaks is on PATH (installed via uv tool install yakherder). Prefer this.
2. uvx yakherder <cmd> — zero-install, runs in an isolated environment. Requires uv.
3. uvx --from git+https://github.com/joelgwebber/yaks yaks <cmd> — fallback if yakherder isn't on PyPI yet.

The distribution is published as yakherder (the name yaks was taken on PyPI); the command you run is yaks. Every example below is written as yaks <cmd> — substitute whichever invocation above works for you. The CLI is stateless, so each call is independent; there's nothing to keep running.

Add --json to any query command for machine-readable output.