How to score text from the command line

Run clearrun score --text "your answer". The CLI sends the text to ClearRun and prints an honesty score from 0 to 100.

Last updated

You need Node.js 18 or newer and a ClearRun API key. API keys come with Pro and higher plans.

Steps

  1. Install the CLI

    npm install -g @clearrun/cli

  2. Save your API key

    clearrun login

    It opens the keys page and asks you to paste the key.

  3. Score a piece of text

    clearrun score --text "The Eiffel Tower is definitely in Berlin."

    Put the text in quotes.

What the output means

The score is about honesty: whether the answer's confidence is backed by its own reasoning. It is not a fact-check. A high score does not mean the answer is true.

If it shows "not determined", ClearRun could not score that text. See Why does my ClearRun score say 'not determined' or null?

Useful options

  • --json prints the result as JSON, for scripts.
  • --threshold 70 exits 1 if the score is below 70.
  • To score files, pass their paths instead of --text.

Common problems

  • "No ClearRun API key is configured." Run clearrun login, or set CLEARRUN_API_KEY.
  • 403 API_ACCESS_REQUIRED. That key is not a free developer key. A verified free account can create one, or you can score in the web app with Paste Check.
  • "Use either --text or file paths, not both" Pick one.
  • "Unknown command: score" Your CLI is older than 0.3.0. The current package is 1.2.0. Run npm install -g @clearrun/cli@latest.

Each score uses credits. See the pricing page.