Install
Getting started

Quick start

From an empty folder to your first AI-vs-human attribution report — in under five minutes.

Install the CLI

Pick the one-liner for your platform. It downloads the binary, runs blamely install, and wires up the daemon and git hooks.

macOS

terminal
curl -sSL https://blamely.ai/blamely-mac-install.sh | bash

Linux

terminal
curl -sSL https://blamely.ai/blamely-linux-install.sh | bash

Windows (PowerShell)

terminal
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://blamely.ai/blamely-windows-install.ps1 | iex"

Full details: Install the CLI.

Verify

Confirm the daemon is running and your AI tools were auto-detected.

terminal
blamely status

Create a new directory

Start fresh so you can watch attribution build from the very first line.

terminal
mkdir my-project
cd my-project

Initialize git

Blamely stores attribution alongside your commits, so the folder needs to be a git repository.

terminal
git init

Create a README and make the initial commit

terminal
echo "# My Project" > README.md
git add README.md
git commit -m "initial commit"

Write code with your AI assistant

Open the project in your editor and let your assistant generate code. Blamely records each line as AI or human as you go — no extra steps.

  • Claude
  • Copilot
  • Cursor
  • Codex
  • OpenCode
  • Antigravity
  • Devin

Commit your work

Stage your changes

terminal
git add .

Commit

terminal
git commit -m "first blamely commit"

A summary bar prints the moment the commit lands:

terminal
AI 59% (20)  [████████████████████░░░░░░░░░░░░░░░░░░░░]  Human 41% (14)

Inspect what was attributed

The attribution is saved as a git note on the commit, so it travels with your repository.

Open the full HTML report

Generates a rich, shareable report and opens it in your browser.

terminal
blamely report HEAD --html

Or read the report in your terminal

terminal
blamely report HEAD

Where to go next

  • CLI commands — every subcommand and flag.
  • How it works — the detection model, the hook flow, the git notes layout.
  • Reports — read attribution from the git notes Blamely writes on every commit.

Something unclear or wrong? Tell us.