Install
CLI reference

Commands

Every blamely subcommand at a glance.

All commands

CommandDescription
blamely installDetect AI tools, install hooks, register the daemon, add a PATH entry
blamely uninstallReverse everything install did. Attribution history is kept
blamely statusDaemon health, detected tools, recent activity counts
blamely doctorRead-only self-check with fix recommendations
blamely detectList which AI tools were found on this machine
blamely repairRemove stale per-repo post-commit hooks from older versions
blamely report [<sha>]Line-by-line attribution for a commit; --html opens a browser dashboard instead
blamely stats [<sha>]Deep per-commit view: files, tools, tokens, coding time
blamely historyAggregate attribution across noted commits
blamely daemonRun the daemon in the foreground (debugging)
blamely --versionPrint the version

NO_COLOR=1 disables ANSI colors.

Status and self-check

terminal
blamely status
# Daemon: running (port 51947)
# Tools detected: claude, cursor, copilot
# Recent activity: 23 edits in the last hour

blamely doctor
# ✓ Binary at ~/.blamely/bin/blamely
# ✓ Daemon agent installed (launchd)
# ✓ Global hook: /Users/you/.blamely/git-hooks
# ✓ Claude Code hook
# ✓ Cursor hook
# ...

doctor is purely diagnostic and prints suggested fix commands when something is off. It never modifies state.

Per-commit reports

terminal
blamely report HEAD
# AI 72% (18)  [████████████████████████████░░░░░░░░░░░░]  Human 28% (7)

blamely report a1b2c3d
# same shape, for any commit that has a Blamely note

For a deeper breakdown:

terminal
blamely stats HEAD
terminal
commit a1b2c3d4e5f6  "Add user authentication"  (2h ago)
  author: you@example.com
  branch: main

Changes:
  +25 added  (AI 18 · human 7)
  ─────────
  25    net

AI attribution:
  claude       12 lines  chat          claude-opus-4-6  in=4.2k out=890 cache=1.1k
  cursor        6 lines  chat          composer-1       in=1.1k out=340 cache=0

Coding time:  ~47 min  (first edit → commit)

History (aggregate)

terminal
blamely history
blamely history --since 7d
blamely history --since 30d
blamely history --since 1y
blamely history --all          # include every tracked repo, not just the current one

--since accepts Nd (days), Nh (hours), and 1y.

Lifecycle

terminal
blamely install     # idempotent. Re-run after installing a new AI tool.
blamely uninstall   # remove hooks, daemon agent, PATH entry. Keeps history.
blamely repair      # remove stale per-repo hooks from older versions.

Manual daemon control

Normally the daemon is managed by launchd / systemd / Scheduled Task. For debugging:

terminal
blamely daemon      # runs in the foreground. Ctrl+C stops it.

The auto-managed instance writes logs to ~/.blamely/daemon.log.

Next

Something unclear or wrong? Tell us.