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

ait tag — Complete Reference

Create, inspect, list, and remove local AIT Tag references to recorded state.

Audience: Developers and release operators

Open Command Manual

Operating boundary#

Purpose: Create, inspect, list, and remove local AIT Tag references to recorded state.

Effect class: Tag-reference mutation with read-only list and show operations.

Coverage: 5 public help surfaces under ait tag.

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

Complete command tree#

Code · text
ait tag
ait tag create
ait tag list
ait tag show
ait tag delete

Exact emitted help#

ait tag#

Binary description: Create, inspect, list, and delete local-only AIT Tags that name exact Snapshots. An existing Tag binding cannot be retargeted, and deleting a Tag never deletes its Snapshot.

Code · text
Create, inspect, list, and delete local-only AIT Tags that name exact Snapshots. An existing Tag binding cannot be retargeted, and deleting a Tag never deletes its Snapshot.

Usage: ait tag <COMMAND>

Commands:
  create  Create a local Tag; existing names are rejected.
  list    List all local Tags without changing repository state.
  show    Show one exact local Tag without changing repository state.
  delete  Delete only one local Tag reference.
  help    Print this message or the help of the given subcommand(s)

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

ait tag create#

Binary description: Create one local AIT Tag for an exact existing Snapshot. When --snapshot is omitted, the current Line head is used. An existing Tag name is always rejected and cannot be replaced or moved.

Code · text
Create one local AIT Tag for an exact existing Snapshot. When --snapshot is omitted, the current Line head is used. An existing Tag name is always rejected and cannot be replaced or moved.

Usage: ait tag create [OPTIONS] --message <MESSAGE> <NAME>

Arguments:
  <NAME>
          New local Tag name; an existing name is rejected.

Options:
      --snapshot <SNAPSHOT_ID>
          Exact existing local Snapshot ID; defaults to the current Line head.

      --message <MESSAGE>
          Required non-empty, single-line reason for creating the Tag.

      --json
          Emit the created Tag as stable JSON.

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

ait tag list#

Binary description: List all local Tags without changing repository state.

Code · text
List all local Tags without changing repository state.

Usage: ait tag list [OPTIONS]

Options:
      --json  Emit the complete local Tag list as stable JSON.
  -h, --help  Print help

ait tag show#

Binary description: Show one exact local Tag without changing repository state.

Code · text
Show one exact local Tag without changing repository state.

Usage: ait tag show [OPTIONS] <NAME>

Arguments:
  <NAME>  Exact local Tag name to inspect.

Options:
      --json  Emit the Tag record as stable JSON.
  -h, --help  Print help

ait tag delete#

Binary description: Delete one exact local AIT Tag reference. The referenced Snapshot, Line heads, and workspace content remain unchanged.

Code · text
Delete one exact local AIT Tag reference. The referenced Snapshot, Line heads, and workspace content remain unchanged.

Usage: ait tag delete [OPTIONS] <NAME>

Arguments:
  <NAME>
          Exact local Tag name to delete.

Options:
      --json
          Emit the deleted Tag record as stable JSON.

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

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