CLI reference

Verel ships two console scripts: verel (interactive / agent commands) and verel-ci (the gated CI entry point). Both support -h.

verel

Command	Purpose
doctor	Check the environment (keys, dependencies).
version	Print the Verel version.
loop	Run the visual loop over an artifact (the eyes).
fleet	LLM-manager fan-out over artifacts toward a goal.
heal	Self-healing CI — failing tests → an agent fixes → green.
ci	Delegate to verel-ci (agent-run CI).

verel loop <artifact> [--backend BACKEND] [--max-iter N]
verel fleet <goal> --artifacts A [A ...] [--backend BACKEND] [--max-iter N]
verel heal --repo PATH [--max-rounds N]
verel doctor

verel-ci — the CI gate

Runs the verdict bus (tests + lint + types) and exits non-zero on a fail verdict, so it wires straight into CI or a git hook.

Command	Purpose
check --repo PATH [--no-lint]	Run the inner-loop stage, print the verdict, exit non-zero on FAIL.
precommit --repo PATH [--no-lint]	Pre-commit stage — aborts a commit on FAIL.
install --repo PATH	Install a native git pre-commit hook.

verel-ci check --repo .        # gate; exit 0 unless verdict == fail
verel-ci install --repo .      # wire a native pre-commit hook

For drop-in CI/pre-commit usage (GitHub Action, .pre-commit-config.yaml) see Get started.