TOKEN-FAIRNESS — The token-aware job scheduler

Plugin scheduler from marketplace token-fairness in agentic-underground/token-fairness. Commands read from the repo's manifest — 1 month ago.

Skills (5)

• check

  Verify TOKEN-FAIRNESS's dependencies are installed and reachable — a ✓/✗ table by tier. Trigger with /scheduler:check (or "check the scheduler prerequisites", "is tf installed?"). The deterministic core is a static binary (bin/tf) with zero runtime deps; the hooks use jq, off-peak cron uses flock +

• tf-help

  Show the token-fairness CLI surface. Trigger with /scheduler:tf-help (or "what tf commands are there?", "show the tf help"). Runs `tf --help` LIVE through the hook wrapper and surfaces the binary's own output verbatim — the subcommand list is never hardcoded, so it can never drift from the installed

• tf-report

  Show the token-fairness honesty report for this project. Trigger with /scheduler:tf-report (or "show the honesty report", "what has this project spent?"). Runs `tf report . --honesty` LIVE through the hook wrapper and surfaces the output verbatim. If the report tool exits non-zero (e.g. a bad path),

• tf-reset

  Re-baseline the token-fairness session. Trigger with /scheduler:tf-reset (or "reset the budget baseline", "re-baseline the session"). WARNS first if a cost-journal entry is still open, then runs `tf budget set --reset` and `tf session-boundary` and surfaces the new baseline. type: mutating output: t

• token-scheduler

  Run a large, token-intensive, wide-reaching job SAFELY — without ever exhausting the usage limit or causing a paid lockout. Trigger with /concierge:schedule (or "this is a big fan-out", "review every reviewer/handler", "run this overnight", "schedule this off-peak", "will this blow my token budget?"

Slash commands (4)

• /scheduler:schedule

  Run a large, token-intensive fan-out SAFELY — estimate cost, require an explicit +Xk budget, gate every wave against the LIVE 5-hour window, halt before a lockout, and run off-peak (22:00–08:00) while reserving your morning allowance.

• /scheduler:tf-help

  Show the token-fairness CLI surface — runs `tf --help` live and surfaces every subcommand, then lists the slash commands that wrap them. The list is never hardcoded; it always reflects the installed binary.

• /scheduler:tf-report

  Show the token-fairness honesty report for this project — runs `tf report . --honesty` live and surfaces the output verbatim. If the report tool errors (e.g. a bad path), the error is surfaced, never a fabricated report.

• /scheduler:tf-reset

  Re-baseline the token-fairness session — runs `tf budget set --reset` then `tf session-boundary`, confirming the new baseline. Warns first if a cost-journal entry is still open, so an in-flight unit of work is not silently re-baselined.

MCP servers (1)

• tf

  runs: bash ${CLAUDE_PLUGIN_ROOT}/hooks/tf-hook.sh mcp

Hooks (13)

• PreToolUse

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/tf-hook.sh preflight-fanout 2>/dev/null || true

• PreToolUse

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/tf-hook.sh preflight-spend 2>/dev/null || true

• SessionStart

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/ensure-statusline-widget.sh 2>/dev/null || true

• SessionStart

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/tf-hook.sh session-boundary >/dev/null 2>&1 || true

• SessionStart

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/tf-hook.sh snapshot 2>/dev/null || true

• SessionStart

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/startup-report.sh 2>/dev/null || true

• SessionStart

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/inject-token-safety.sh 2>/dev/null || true

• SessionStart

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/offer-scheduler.sh 2>/dev/null || true

• PostToolUse

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/tf-hook.sh snapshot 2>/dev/null || true

• PostToolUse

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/spend-capture-throttled.sh 2>/dev/null || true

• Stop

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/tf-hook.sh snapshot 2>/dev/null || true

• Stop

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/session-tokens.sh 2>/dev/null || true

• Stop

  bash ${CLAUDE_PLUGIN_ROOT}/hooks/tf-hook.sh spend --capture >/dev/null 2>&1 || true

Similar plugins