Run champrep --help and champrep COMMAND --help for the exact flags shipped
by the installed version. This page summarizes the current public command tree.
champrepsearch"what did we decide about pricing"--ai
A search costs one rate-limit unit per service actually searched, so narrowing
with --service is the cheapest way to keep it responsive. --ai spends your
monthly AI credits; without credits the command still returns normal results
and tells you why the AI ranking did not run.
Projects, branches, merge requests, issues, pipelines, job logs, and releases.
PROJECT is the project’s full path (acme/web) or its ID. Full reference:
CHAMPREP Code commands.
Command
Purpose
champrep code projects ls / show / create
List, show, and create projects.
champrep code repo clone-url PROJECT
Print the clone address (--ssh for SSH).
champrep code clone
Clone projects, a group (--group, --include-subgroups) or all yours (--membership, --owned, --all) into a namespace tree; --update keeps it current.
champrep code branches ls PROJECT
List branches.
champrep code mr ls / show / create / merge / approve
Work with merge requests.
champrep code issues ls / show / create / close / reopen
Work with issues.
champrep code pipelines ls / show / run / retry / cancel
Work with pipelines.
champrep code pipelines wait PROJECT [ID]
Wait for a pipeline, the newest of a commit (--sha), or the newest on --ref to finish; exits 0 on success, 1 otherwise, 8 on --timeout.
champrep code jobs ls / log / play / retry
List jobs, print or follow (--follow) a log, start manual jobs.
champrep code releases ls PROJECT
List releases.
champrep code runners ls / show / update / create
List runners and who is online, change tags, pause and resume, create a runner.
runner-farm also accepts the rf alias. --workspace picks the farm
account (personal, organization:<id>, team:<id>). Full reference:
Runner Farm commands.
Command
Purpose
champrep rf accounts ls / show
List the farm accounts you can act in; show one.
champrep rf connections ls
List code host connections.
champrep rf pools ls / show / create / update
Manage runner pools, including --pause and --resume.
Repositories, scans, findings, quality gates, previews, and IDE workspaces.
REPO is a repository key such as code:<project-uuid>. Full reference:
CHAMPREP QA commands.
Command
Purpose
champrep qa repos ls / available / activate / deactivate / sync
Manage the repositories QA analyses.
champrep qa scan REPO
Start a scan; --watch follows it to the end.
champrep qa scans ls / show
List and show scans.
champrep qa findings ls / show / dismiss / reopen
Filter (--severity, --cwe, --branch, --state) and triage findings.
champrep qa gates status REPO
Show the quality gate result; exits 1 when it fails.
champrep qa previews ls / show / create / extend / stop
In these three families, commands that change something or use CI minutes,
credits, or allowance ask first: code mr create, mr merge, mr approve,
issues close and reopen, every pipeline and job action, rf pools create
and update, and every qa write (repos activate and deactivate, scan,
findings dismiss and reopen, previews create, extend and stop, ide start and stop). Pass --yes (-y) in scripts; without a terminal and
without --yes, they change nothing. Creating a Code project or issue does
not ask. --workspace on rf and qa picks the account that is used and
charged.
Manage the cpk_... keys used for headless and CI access. These commands
require an interactive browser session (run champrep auth login first, not
auth token). Creating or rotating a key prints the secret once.
Command
Purpose
champrep keys ls
List your API keys.
champrep keys create
Create a key (--name, repeatable --scope, --expires-in-days, --allowed-ip).
champrep keys get KEY_ID
Show one key’s details.
champrep keys audit KEY_ID
Show a key’s recent audit log.
champrep keys update KEY_ID
Change name, scopes, IP allowlist, or --active/--inactive.
General or usage failure, or a refusal that signing in again does not fix: no access to the item, not on your plan, payment or credits needed, your role, or a decision that needs your web session.
3
Authentication is required or invalid.
4
The credential lacks the required scope.
5
A live Gateway limit was reached.
6
Network failure.
7
Gateway or service failure.
8
A wait ran out of time: code pipelines wait --timeout.
Scripts should check the exit code and parse --json output when it is
available. Do not match human-readable error sentences as a stable interface.
Every Gateway response carries your current limits. The CLI transparently
retries a short per-minute limit, honoring Retry-After. It does not sleep
through a per-day limit or any wait longer than a few seconds — instead it exits
with code 5 and reports the exact wait, so scripts fail fast. Check your live
counters any time with champrep account.