@scoreflow/cli

@scoreflow/cli

Live XP + levels for AI-assisted work, surfaced in your terminal.

Companion CLI to Scoreflow — the teams-first scoring product that measures AI craftsmanship (not volume). Install it once, run scoreflow init, and a Claude Code Stop hook wires itself into your ~/.claude/settings.json. Every prompt shows a +X XP nudge, a level-up banner, or an achievement unlock — right in the session.

Install

npm install -g @scoreflow/cli

Requires Node.js 20+. Works on macOS, Linux, and WSL.

Quickstart

# 1. Sign up at https://scoreflow.dev/signup and grab your user token
scoreflow init

# 2. Work normally in Claude Code. After every response you'll see:
#    +2 XP scoreflow   (Level 3)
#    🏆 Level up! 3 → 4 Karpathy
#    🎖  Unlocked: First Session

Commands

Command	Purpose
scoreflow init	Interactive setup. Writes ~/.scoreflow/config.json and adds a Stop hook to ~/.claude/settings.json.
scoreflow hook	Called by Claude Code after each response. Reads your progression, diffs against the cached snapshot, prints the delta. Silent on no-change.
scoreflow status	One-shot readout: current level, XP, per-skill breakdown, progress to next level.
scoreflow leaderboard	Global top 20 by cumulative XP.

What it measures

Scoreflow scores you across four components (bands, not monotones — gaming any of them collapses your score):

• Effectiveness (35%) — tool acceptance rate, plan-mode ratio
• Craftsmanship (25%) — cache hit ratio, rules-file freshness, skills breadth
• Outcome (25%) — PR merge rate, CI-first-pass, durability
• Breadth (15%) — distinct tools, modalities, repos

XP is derived from your daily CCS × streak multiplier × team multiplier. Allocated across 11 skill tracks (File Craft, Research, Automation, Agents, Writing, Analysis, Synthesis, Conversation, Teaching, Project Management, Creativity) based on your tool-call distribution that day.

Privacy

• No prompt content stored. Ever. Only metadata: lengths, token counts, acceptances, timestamps.
• Team aggregates by default. Individual rankings require explicit opt-in.
• EU data residency. Events + scores live on Hetzner Frankfurt.

Links

• Product — https://scoreflow.dev
• Docs — https://scoreflow.dev/docs (soon)
• Repo — https://github.com/8infinitelabs/scoreflow
• Issues — https://github.com/8infinitelabs/scoreflow/issues

License

MIT © Infinite Labs OÜ