The command line
Install the vraelis CLI, check a claim from a terminal, and read the decision from its exit code.
- Outcome
- You can check a claim from a terminal or a script and act on its exit code.
- Does not do
- It does not approve plans; a person approves from the link it prints.
The vraelis CLI calls the same API. verify prints the plan and the approval link, opens the link when a person is at the terminal, waits for the approval, runs the check and exits on the decision. In CI the exit code is what an if-statement reads.
Install and sign in
This example called the earlier service, which is retired. Its commands and endpoints are no longer shown.
In CI and scripts, set VRAELIS_API_KEY instead of signing in. The environment takes precedence over a stored key, so a pipeline never uses a key someone left on the machine. [Create an API key]((retired endpoint))
Check a claim
This example called the earlier service, which is retired. Its commands and endpoints are no longer shown.
Exit codes
| Exit code | What it means |
|---|---|
0 | Verified. The claim held on the live app, with evidence. |
1 | Failed. The claim did not hold; a repair prompt is attached. |
2 | Blocked, or the tool could not run at all. |
The CLI collapses “blocked” and “could not run” into 2, because a gate should treat “I could not check” the same as “no verdict.” A hand-rolled gate that polls the API can split those out, exiting 3 when no decision is reached in the window.
Options
| Option | What it does |
|---|---|
--wait | Wait for the verdict. Without it the command prints the id and exits 0 immediately, which means started, not verified. |
--json | Emit one JSON object instead of human output. This is the mode for CI and for agents. |
--repair-prompt | On failure, print only the repair prompt, ready to pipe into a coding agent. |
--idempotency-key | Reuse a key so a retry returns the original verification instead of starting, and paying for, a second one. |
--timeout | How long --wait waits (for approval and for the decision) before giving up. Default 900 seconds. |
--no-open | Print the approval link without opening a browser. |
Other commands
| Command | What it does |
|---|---|
| (retired command) | Show a verification's decision. |
| (retired command) | Plug Vraelis into Claude Code, Codex, Gemini CLI, Copilot, Cursor or Trae, and tell them to verify before saying done. |
| (retired command) | Run the MCP server the assistants talk to. They start it for you. |
| (retired command) | Show which key is in use, where it came from, and whether it works. |
| (retired command) | Forget the stored key. |
With no person at the terminal
A CI job has no person at the terminal, and a key cannot approve a plan, so the first check of a claim waits on the link until someone approves it or --timeout runs out. Re-checks of that approved plan need no new approval within 24 hours of the approval, up to 10 times, on the same address. A new preview URL is a different address, so its first check waits for a person again.
The CLI installs from the script above, on macOS, Linux and Windows. Its npm package is prepared and not published.