fnl-status

Installation
SKILL.md

Usage dashboard

The dashboard is a static page, dashboard.html, in the state folder (${FNL_STATE_DIR:-~/.finolabs/vibecode/state}; an existing ${XDG_STATE_HOME:-~/.local/state}/finolabs-vibecode is used while there is no new folder). It loads its numbers from a data.js beside it. This skill never writes or edits the page; a script rebuilds the data and copies the shipped page.

The scripts are in this skill's base directory: scripts/refresh.py builds the dashboard data, and the fnl-delegate skill beside this one holds scripts/ledger.py. Without fnl-delegate, the dashboard still shows the usage events and names the ledger as a missing source.

Arguments: $ARGUMENTS

Steps

  1. Run python3 -I <refresh.py> run --open. It rebuilds data.js, copies the page and opens it in the default browser. Done when it prints its one-line summary. While its tab is visible the page reloads data.js every 5 seconds, and the hooks rebuild it during a session, so the user can leave it open.
  2. Report that line, then name each missing source it lists and what fixes it: consent not given means fnl-setup; no events means the plugin's hooks need the whole plugin and a session started after consent; a missing ledger means fnl-delegate "Ledger".
  3. Run python3 -I <ledger.py> open. It prints each open dispatch's age against its budget. For each one past its check deadline (half the budget), check liveness from artifacts as fnl-delegate "Budget and liveness" says and mark it running, stalled or ended without a finish line. A coordinator closes a record only when its log or the repository shows how the run ended, with that outcome and a note that it was closed late; otherwise list it and ask the user.
  4. Read the Review by date (ISO, YYYY-MM-DD) at the top of references/models.md in the fnl-delegate folder. When today is past it, the capability map is stale: say so, with the date, since routing still reads it.

The page marks a delegation group of fewer than five runs with an open ring and passes no judgment on it. A group of five or more is judged by first-pass acceptance below 60%.

Purge

Installs
1
GitHub Stars
4
First Seen
Nov 4, 2026