Validation

The validate command runs an AI-powered validation workflow against your codebase inside a Docker container.

Usage

verlign validate [options]

Options

Examples

Validate the current directory:

verlign validate

Validate a specific project:

verlign validate --path /path/to/project

Requirements

• You must be logged in before running a validation
• Docker must be running on your machine

What happens

When you run verlign validate, the CLI:

1. Pulls the Docker image — ghcr.io/onerlaw/verlign-worker:latest
2. Creates a container with:
   • Your codebase mounted at /workspace
   • Your API key and API URL passed as environment variables
3. Streams output from the container to your terminal in real time
4. Cleans up the container when the workflow completes

The container name follows the pattern verlign-{timestamp}.

Reading the output

The validation output is streamed directly to your terminal. You will see:

• Step progress as the AI agent analyzes your codebase
• Findings and suggestions identified during validation
• A summary at the end of the run

Stopping a validation

Press Ctrl+C to stop a running validation. The CLI handles SIGINT and SIGTERM gracefully and stops the Docker container.