ait-native
Browse RC.8 documentation
RC.8 Documentation revision 1

ait-runner — Complete Reference

Diagnose, execute, claim, or serve typed server-owned CI work.

Audience: Developers, integration maintainers, and operators

Open Command Manual

Operating boundary#

Purpose: Diagnose, execute, claim, or serve typed server-owned CI work.

Coverage: 5 public help surfaces emitted by ait-runner.

This page preserves the admitted RC.8 executable output in full. It is generated from the checksum-bound release binary, including every emitted argument, option, default, possible value, conflict, and requirement.

Complete command tree#

Code · text
ait-runner
ait-runner doctor
ait-runner execute
ait-runner run-job
ait-runner serve

Exact emitted help#

ait-runner#

Code · text
Native execution plane for explicit ait-server CI jobs

Usage: ait-runner <COMMAND>

Commands:
  doctor   Verify the live ait-server health contract without claiming a job
  execute  Execute one typed native request from stdin or a named file
  run-job  Claim, execute, and finish one explicit Binary Worker Job pair
  serve    Poll for compatible native jobs, maintain their lease, and deliver results
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

ait-runner doctor#

Code · text
Verify the live ait-server health contract without claiming a job

Usage: ait-runner doctor --server <SERVER>

Options:
      --server <SERVER>  
  -h, --help             Print help

ait-runner execute#

Code · text
Execute one typed native request from stdin or a named file

Usage: ait-runner execute [OPTIONS]

Options:
      --request <REQUEST>            [default: -]
      --source-root <SOURCE_ROOT>    [default: .]
      --attempt-root <ATTEMPT_ROOT>  
  -h, --help                         Print help

ait-runner run-job#

Code · text
Claim, execute, and finish one explicit Binary Worker Job pair

Usage: ait-runner run-job [OPTIONS] --server <SERVER> --repository-index <REPOSITORY_INDEX> --worker-job-index <WORKER_JOB_INDEX>

Options:
      --server <SERVER>                      
      --repository-index <REPOSITORY_INDEX>  
      --worker-job-index <WORKER_JOB_INDEX>  
      --source-root <SOURCE_ROOT>            [default: .]
      --attempt-root <ATTEMPT_ROOT>          
  -h, --help                                 Print help

ait-runner serve#

Code · text
Poll for compatible native jobs, maintain their lease, and deliver results

Usage: ait-runner serve [OPTIONS] --server <SERVER> --worker-id <WORKER_ID>

Options:
      --server <SERVER>                                
      --worker-id <WORKER_ID>                          
      --repository-index <REPOSITORY_INDEXES>          
      --once                                           
      --poll-interval-ms <POLL_INTERVAL_MS>            [default: 1000]
      --heartbeat-interval-ms <HEARTBEAT_INTERVAL_MS>  [default: 30000]
      --source-root <SOURCE_ROOT>                      [default: .]
      --attempt-root <ATTEMPT_ROOT>                    
  -h, --help                                           Print help

Capture authority#

  • Product version: 1.0.0-rc.8
  • Binary version: ait-runner 1.0.0-rc.8
  • Binary SHA-256: fffeb2873ecdc940e6abd75c4e7e0463c1c5265e781faeae51ca36502c580a20
  • Captured: 2026-08-17

Version authority

Checked against the exact RC.8 source

This page is public documentation, not a second product contract. Use the exact source and distribution contract for release authority.

Open RC.8 Release ↗Distribution Contract ↗CLI Source ↗
Owning component Snapshots
  • ait-coreSNP-F136DB9A342B
  • ait-serverSNP-FBF302ADABC5
  • ait-runnerSNP-DF67532B0360
  • ait-pythonSNP-39225802847F
  • ait-nodeSNP-3D474B60B26F