How to get your first ClearRun score in five minutes

Create an API key, save it with npx @clearrun/cli login, then run npx @clearrun/cli score --text "your answer". You need Node.js 18 or newer. A verified free account can create one developer key. The current CLI is 1.2.0.

Last updated

The clip above shows every step. The same steps in text:

Steps

  1. Create an API key

    Sign in at api.clearrun.net/account/keys and choose Create API key. Copy the key now. It is shown only once.

  2. Save the key

    npx @clearrun/cli login

    Paste the key when the CLI asks. It saves it on your computer.

  3. Score an answer

    npx @clearrun/cli score --text "The Eiffel Tower is definitely in Berlin."

What you see

The CLI prints ClearRun Score from 0 to 100, a grade, a risk level, any issues, and a one-line summary.

A higher score means the answer's confidence looks backed by its reasoning. It does not mean the answer is true. See What does the honesty score mean?

No Pro plan yet?

Try the SDK in mock mode first. It needs no key and returns local test scores. See How to use ClearRun mock mode for local development.

If it does not work

  • "No ClearRun API key is configured." Run npx @clearrun/cli login again, or set CLEARRUN_API_KEY.
  • 403 API_ACCESS_REQUIRED. That key is not a free developer key. Create one on a verified free account, or score in the web app with Paste Check.
  • "Unknown command: score" You have an old CLI. Use npx @clearrun/cli@latest.