wbso-cli

CLI for Dutch WBSO / S&O hours administration (urenadministratie). Installs as the wbso command.

Install + set up

Open your WBSO binder in the TATOMA Binders app, choose Connect your agent to mint a key, then paste its one-liner into your agent (or run it yourself):

npx wbso-cli@latest init --key <wbso_...> --url <binders-url>

init writes ~/.wbso/config.json, installs the wbso agent skill into ~/.claude/skills/wbso/ (use --agent codex for ~/.codex), verifies the key, and classifies this repo into per-project path rules (suggest-paths).

Usage

wbso status                        # realisatie so far + open deadline gaps
wbso scan --since "30 days ago"    # propose S&O hours from git (books nothing)
wbso add --date 2026-07-06 --project <id> --hours 4 --desc "..."
wbso list                          # the hours ledger, with row ids
wbso correct --id <id> --hours 3   # restate/void a booked entry (--hours 0 voids)
wbso export --from 2026-04-01 --to 2026-06-30 --out urenstaat.xlsx   # controle pack + RVO urenstaat

Config resolves from WBSO_BASE_URL / WBSO_API_KEY env, then ~/.wbso/config.json. Built by TATOMA.