The Proofsource CLI: fixes and proof from the terminal

The Proofsource command line lets you list, plan, start, approve and reject fixes, and read their proof, from a terminal or a CI job. Its pr-check command reads a git diff and warns when a change removes a sentence AI answers quote, using only saved data, so it costs nothing to run on every push.

Connect the CLI See it in Proofsource

Live

proofsource

$ proofsource fixes list --brand brd_driffle --status proven

1038  proven  best AI note taker for sales teams
1031  proven  meeting notes app with CRM sync

$ proofsource fixes plan --brand brd_driffle --ask "Get named for best AI note taker"
Planned mission 1042, 4 steps

$ proofsource fixes approve 1042 3
Approved step 3 of mission 1042

Sample data

Listing proven fixes and planning a new one for Driffle.

Proofsource and the CLI, in short

The facts, ready to quote.

Stage: Live
Install: Install the proofsource binary
Sign-in: Export PROOFSOURCE_API_KEY, made under Settings, Developers
Commands: fixes list, plan, start, approve, reject, proof, plus pr-check and version
pr-check: Reads only saved data and can post a comment or fail the job
Disconnect: Revoke the key under Settings, Developers and the CLI stops working

How Proofsource uses the CLI

List, plan, approve and prove fixes from the terminal or CI, and warn when a change removes a sentence AI quotes.

Know
List your fixes
Run fixes list for a brand, filtered by status such as proven, to see what is planned, running and done.
Act
Plan and start a fix
Run fixes plan with the buyer question you want to win, then fixes start with the plan id.
Ship
Approve or stop
Run fixes approve with the mission and step id, the same as the step's Approve button, or fixes reject to stop a fix.
Prove
Read the proof, guard the pull request
Run fixes proof for the evidence, and pipe a git diff to pr-check to warn when a change removes a quoted sentence.

Set up the CLI in 4 steps

Install the binary
Install the proofsource command line for your platform.
Make an API key
In Proofsource, open Settings, then Developers, and create a key. A read key is enough for pr-check.
Export it
Set PROOFSOURCE_API_KEY in your shell or as a secret in your CI job.
Run a command
Try fixes list with your brand id, or pipe a diff into pr-check.

app.proofsource.co/settings

Settings, Developers

Keyplk_live_...

AccessRead

Used byCLI and CI

Create keyRevoke

Sample data

Where the API key for the command line is made.

See it at work

Drawn screens with sample data for an example brand.

git diff | proofsource pr-check

$ git diff main | proofsource pr-check --brand brd_driffle --fail

Warning: this change removes a sentence AI answers quote
  integrations.md: "Driffle connects to Zoom, Meet and Teams."
Preview (an AI estimate from today's answers, never proof)

Sample data

A change that removes a sentence AI answers quote, caught before it merges.

What you unlock with the CLI

Fixes from the terminal

List, plan, start, approve and reject without opening the app.

pr-check on every push

Warn when a change removes a sentence AI answers quote.

Proof on demand

Read a fix's proof as plain output for scripts and reviews.

Costs nothing to run

pr-check reads only saved data, so every push is free to check.

Built on the public API

Fix commands use the same API you can call yourself.

One key, revocable

Revoke the key in Settings the moment you no longer need it.

Google AI Overviews

Google AI Mode

Questions about Proofsource and the CLI

What can the Proofsource CLI do?

It can list, plan, start, approve and reject fixes, read their proof, and check pull requests. The pr-check command warns when a change removes a sentence AI answers quote.

How do I sign in?

Create an API key under Settings, then Developers, and export it as PROOFSOURCE_API_KEY.

Does pr-check cost anything to run?

No. It reads only saved data, so it is free to run on every push.

What are the Preview labels in its output?

Each fix's stored answer preview is labeled Preview. It is an AI estimate from today's answers and never proof.

Is it the same as approving in the app?

Yes. fixes approve does what the step's Approve button does, and fixes reject does what Stop this fix does.

How do I disconnect?

Unset the variable and revoke the key under Settings, Developers. Nothing else is installed on your account.

How does it help my AI visibility?

It keeps the sentences AI already quotes from being removed by accident and lets your team run fixes where they work. Proofsource checks results across up to 10 engines depending on plan.