ait-native
Browse 1.1.1 documentation
1.1.1

ait repo — Complete Reference

Inspect or administer a registered remote Repository and its CI jobs, capabilities, and runs.

Audience: Repository owners and operators

Open Command Manual

Operating boundary#

Purpose: Inspect or administer a registered remote Repository and its CI jobs, capabilities, and runs.

Effect class: Mixed remote read and administration surface; retirement, restoration, and CI scheduling mutate remote authority.

Coverage: 6 public help surfaces under ait repo.

The blocks below preserve the 1.1.1 binary output in full, including every emitted argument, option, default, possible value, conflict, and requirement.

Complete command tree#

Code · text
ait repo
ait repo show
ait repo retire
ait repo restore
ait repo jobs
ait repo ci-capabilities

Exact emitted help#

ait repo#

Binary description: Inspect and manage the configured Repository on its remote server.

Code · text
Inspect and manage the configured Repository on its remote server.

Usage: ait repo <COMMAND>

Commands:
  show             Read Repository identity, lifecycle, storage validation, and sync state.
  retire           Drain, archive, verify, and purge a remote Repository, or abort that retirement.
  restore          Restore a complete local retirement archive as a new remote Repository.
  jobs             Read one Worker Job or a bounded, optionally filtered Job inventory.
  ci-capabilities  Inspect server, native runner, and remote-sync prerequisites for Patchset CI.
  help             Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

ait repo show#

Binary description: Read Repository identity, lifecycle, storage validation, and sync state.

Code · text
Read Repository identity, lifecycle, storage validation, and sync state.

Usage: ait repo show [OPTIONS]

Options:
      --remote <NAME>  Use this configured remote; omission uses the Repository default remote.
      --json           Emit the complete machine-readable JSON result.
  -h, --help           Print help

ait repo retire#

Binary description: Without --abort, stop new work for the remote Repository, download and verify its complete archive, then delete its server data. An unrelated complete local archive blocks retirement and must be handled with ait repo restore --remote <NAME>; there is no archive replacement option. With --abort, reactivate the Repository and preserve any complete local archive.

Code · text
Without --abort, stop new work for the remote Repository, download and verify its complete archive, then delete its server data. An unrelated complete local archive blocks retirement and must be handled with `ait repo restore --remote <NAME>`; there is no archive replacement option. With --abort, reactivate the Repository and preserve any complete local archive.

Usage: ait repo retire [OPTIONS]

Options:
      --remote <NAME>
          Mutate this configured remote; omission uses the Repository default remote.

      --abort
          Abort an in-progress retirement and reactivate the Repository while preserving any complete local archive.

      --json
          Emit the complete machine-readable JSON result.

  -h, --help
          Print help (see a summary with '-h')

ait repo restore#

Binary description: Verify the complete .ait/remote/<remote>/ retirement archive, create a new remote Repository index, upload and save its data, then update the locally configured Repository index. The archive determines the restored identity; there is no name, index, or force override.

Code · text
Verify the complete `.ait/remote/<remote>/` retirement archive, create a new remote Repository index, upload and save its data, then update the locally configured Repository index. The archive determines the restored identity; there is no name, index, or force override.

Usage: ait repo restore [OPTIONS]

Options:
      --remote <NAME>
          Use this configured remote; omission uses the Repository default remote.

      --json
          Emit the complete machine-readable JSON result.

  -h, --help
          Print help (see a summary with '-h')

ait repo jobs#

Binary description: Read one Worker Job or a bounded, optionally filtered Job inventory.

Code · text
Read one Worker Job or a bounded, optionally filtered Job inventory.

Usage: ait repo jobs [OPTIONS]

Options:
      --remote <NAME>             Read from this configured remote; omission uses the Repository default remote.
      --worker-job-index <INDEX>  Read one specific Worker Job from the current Repository; cannot be combined with list filters.
      --state <STATE>             Return only queued, running, succeeded, or failed Jobs. [possible values: queued, running, succeeded, failed]
      --limit <COUNT>             Return at most this many Jobs in list mode (1 through 1000; default 50). [default: 50]
      --json                      Emit the complete machine-readable JSON result.
  -h, --help                      Print help

ait repo ci-capabilities#

Binary description: Inspect server, native runner, and remote-sync prerequisites for Patchset CI.

Code · text
Inspect server, native runner, and remote-sync prerequisites for Patchset CI.

Usage: ait repo ci-capabilities [OPTIONS]

Options:
      --remote <NAME>  Use this configured remote; omission uses the Repository default remote.
      --json           Emit the complete machine-readable JSON result.
  -h, --help           Print help

Version authority

Checked against the exact 1.1.1 source

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

Open 1.1.1 Release ↗Distribution Contract ↗CLI Source ↗
Owning component Snapshots
  • ait-coreSNP-ED7593DBF982
  • ait-serverSNP-0CCD7DD2A077
  • ait-runnerSNP-35C9C133D2EE
  • ait-pythonSNP-756C731A4CC0
  • ait-nodeSNP-55E90D0A81F1