hey-ledgerlisted

# hey — ledger conventions `hey` revolves around **one markdown ledger a human reads and edits**. No database, no server. Scripts do all the counting; skills never count by hand. ## Paths ```bash ROOT="${CLAUDE_PLUGIN_ROOT:-$PLUGIN_ROOT}" # Codex names it PLUGIN_ROOT HEY="$ROOT/scripts/hey.py" BOARD="$ROOT/scripts/board.py" ``` Config and history live in `~/.hey/`. | File | What | |---|---| | `config.json` | registered projects with their base branch, default scope, language | | `stats.jsonl` | daily snapshots. Burndown, carry-over and variance derive from these | ## Projects and scope A user may run several projects at once, so commands take a **scope**. ```bash python3 "$HEY" projects # registered projects, and which one you are in python3 "$HEY" add <project root> # register. Ledger defaults to <root>/TASKS.local.md python3 "$HEY" add <root> --init # register and create the ledger from the template python3 "$HEY" add <root> --ledger <path> # when the ledger lives elsewhere python3 "$HEY" add <root> --ledger-log <path> # prose sections in a second file python3 "$HEY" add <root> --base <branch> # when the remote's default branch is not it python3 "$HEY" remove <name> # unregister. Ledger and history are kept python3 "$HEY" scope current|all # default scope python3 "$HEY" doctor # what is misconfigured, all of it at once python3 "$HEY" draft-log --since 14 # work log drafted