RC.8
Documentation revision 1
Technical Documentation
Search and browse versioned ait-native technical guides, command references, integrations, operations, and release contracts.
Audience: Developers, integrators, and operators
Find a technical answer
Search the current documentation
Search page titles, command names, audiences, and technical topics. Every page remains available in the directory below without JavaScript.
Start
- Technical DocumentationThe versioned entry point for ait-native concepts, workflows, commands, integrations, and operations.
- Getting StartedInstall RC.8, initialize one repository, make a request, and inspect the recorded result.
- Core ConceptsUnderstand the repository objects that connect intent, isolated work, immutable state, evidence, and closeout.
- System Architecture and Authority BoundariesSee how external coding clients, native bindings, the ait-native core, Task worktrees, Binary DB, server, and runner connect across local and optional remote authority.
Workflows
- Feature WorkflowFollow a bounded feature request from sprint item through implementation, verification, and closeout.
- Regression WorkflowIdentify the responsible revision, isolate the repair, add a regression test, and close the new Task.
CLI · User and inspection
- ait initCreate or reinitialize AIT repository authority and effective agent instructions.
- ait configInspect effective workflow routing and apply explicit repository configuration changes.
- ait statusInspect the current Line, repository state, workspace state, remotes, and worktree health.
- ait diffCompare the current workspace with the current Line head using bounded path filters.
- ait blameTrace a file or line range to the responsible Snapshot and Plan revision before a repair.
- ait doctorDiscover focused diagnostic surfaces without changing repository authority.
CLI · Agent workflow
- ait planRecord versioned Markdown lineage and synchronize exact sprint items in the configured scope.
- ait taskStart Plan-bound work, inspect readiness, and complete the Task through its configured scope.
- ait snapshotRecord immutable repository state and inspect Snapshot content or ancestry.
- ait queueRead a compact inventory of active work, reviews, remotes, and worktree health.
- ait workflowClassify bounded edits, prepare remote readiness evidence, and inspect closeout state.
CLI · Complete RC.8 reference
- Complete RC.8 CLI ReferenceBrowse every public RC.8 ait command and command group with exact emitted syntax, options, defaults, conflicts, and operating boundaries.
- ait init — Complete ReferenceCreate or reinitialize local AIT repository authority and refresh the effective repository instructions.
- ait agent — Complete ReferenceConfigure, inspect, and run optional Telegram, LINE, Discord, and Slack transport workers and their supervisors.
- ait line — Complete ReferenceInspect and manage Lines, switch or restore workspace state, merge recorded history, and clean eligible Line records.
- ait git — Complete ReferenceImport, export, and mirror history between Git and AIT's native repository model.
- ait blame — Complete ReferenceAttribute a path or line range to recorded Snapshot and Plan lineage, with an explicit bounded restore option.
- ait doctor — Complete ReferenceRun focused diagnostics for the configured memory root, runtime root, or Plan authority.
- ait queue — Complete ReferenceRead active work, review, remote, and worktree inventory in summary form.
- ait remote — Complete ReferenceRegister and list remote authorities or reconstruct a local Line head from an exact remote Repository authority.
- ait release — Complete ReferenceCreate and inspect release dossiers, build and package native artifacts, publish them, and promote admitted releases.
- ait repo — Complete ReferenceInspect or administer a registered remote Repository and its CI jobs, capabilities, and runs.
- ait config — Complete ReferenceInspect effective repository configuration or set an explicit supported configuration value.
- ait external — Complete ReferenceInspect, materialize, pin, link, unlink, and diagnose external repository dependencies.
- ait status — Complete ReferenceInspect the current Line, repository, workspace, remote, and worktree state.
- ait diff — Complete ReferenceCompare the current workspace with recorded state using optional bounded path and output filters.
- ait pull — Complete ReferenceImport a remote Line's Snapshot history, classify head relationships, and optionally materialize the selected result.
- ait push — Complete ReferenceUpload recorded Snapshot history and advance an exact remote Line.
- ait gc — Complete ReferenceInspect, validate, and prune eligible native storage packs.
- ait stash — Complete ReferenceRecord, inspect, apply, and remove local work-in-progress stash entries.
- ait plan — Complete ReferenceRecord Markdown Plan lineage, inspect revisions, and synchronize exact authored Markdown in the selected scope.
- ait task — Complete ReferenceStart Plan-bound work, inspect and audit Task state, land admitted work, or abandon an unfinished Task.
- ait change — Complete ReferenceCreate, inspect, update, cancel, and otherwise manage the Change lifecycle within a Task.
- ait snapshot — Complete ReferenceCreate and inspect immutable repository state, traverse its parent history, and replay or restore recorded content.
- ait tag — Complete ReferenceCreate, inspect, list, and remove local AIT Tag references to recorded state.
- ait patchset — Complete ReferencePublish and inspect Change candidates, select the current candidate, and manage its CI request state.
- ait review — Complete ReferenceRequest, inspect, and record review decisions for a selected Patchset.
- ait attest — Complete ReferenceCreate and inspect typed evidence attached to a selected Patchset.
- ait policy — Complete ReferenceEvaluate, inspect, and explicitly waive supported policy checks for a selected Patchset.
- ait worktree — Complete ReferenceInspect, diagnose, recover, relocate, and clean AIT-owned Task worktrees and their metadata.
- ait workflow — Complete ReferenceClassify bounded edits, reconcile workflow state, prepare remote readiness, and drive configured closeout decisions.
CLI · Complete RC.8 component references
- ait-agent — Complete ReferenceConfigure, inspect, and supervise optional Telegram, LINE, Discord, and Slack transport workers.
- ait-agent-worker — Complete ReferenceRun one admitted native transport worker or one bounded signed-request or reply-provider transaction.
- ait-server — Complete ReferenceInitialize, probe, or run durable remote Repository authority and Worker Job coordination.
- ait-runner — Complete ReferenceDiagnose, execute, claim, or serve typed server-owned CI work.
Infrastructure and integrations
- Parallel Task IsolationRun multiple coding-agent Tasks concurrently through isolated worktrees, AIT_RAM fan-out, immutable evidence, and atomic Land.
- Remote InfrastructureDeploy the explicit ait-server and ait-runner boundary for remote authority, offsite recovery, and repository-owned CI.
- ait-server: Remote Authority and RecoveryUnderstand ait-server remote workflow authority, Snapshot preservation, disaster recovery, runner boundaries, and operating responsibilities.
- ait-runner: Native CI Execution PlaneOperate the RC.8 native runner through exact Worker Job claims, Snapshot materialization, isolated attempts, bounded evidence, leases, and deployment controls.
- ait-server REST API ReferenceCall every RC.8 ait-server HTTP operation with implementation-aligned request fields, responses, errors, recovery flows, and security boundaries.
- ait-agent: Optional Transport ManagerUnderstand the optional RC.8 transport-manager boundary, its four worker families, lifecycle commands, and relationship to the coding client and native worker executable.
- ait-agent-worker: Messaging and Reply RuntimeOperate the optional native messaging worker through its verified command surface, four transports, Codex reply provider, runtime admission, and security boundary.
- Python IntegrationUse the direct in-process Python binding included in the ait-native PyPI distribution.
- Node.js IntegrationUse the direct Node-API JavaScript and TypeScript surface from the supported npm package.
Binary DB v0 Schema
- Binary DB v0: Format and AuthorityRead the Binary DB v0 file format, integer and offset rules, and storage-root boundaries.
- Binary DB v0: Workflow RecordsExpand Task, Change, worktree, Line, Stash, Tag, Land, and inline workflow-link record layouts and invariants.
- Binary DB v0: Snapshot and Content RecordsExpand Snapshot ancestry, Snapshot links, Tree, Blob, object-pack, manifest, and optional file-cache layouts.
- Binary DB v0: Git Interoperability RecordsExpand the optional Git repository, generation, identity, commit, file, ref, Tag, and checkpoint mapping layouts.
- Binary DB v0: Server and Policy RecordsExpand Patchset, attestation, Actor, review, policy, waiver, Plan, Repository registry, and Worker Job authority.
- Binary DB v0: Payloads, Indexes, and EncodingsExpand every typed payload family, rebuildable index record, metadata bit assignment, enum, and reserved-value rule.
- Binary DB v0: Identity, Recovery, and ConversionExpand public handle scopes, atomic write and recovery boundaries, conversion acceptance, capacity, and exclusions.
Reference
- Distribution and ReleaseUnderstand the six-component compatibility family, install-channel roles, and exact RC.8 authority.
- TroubleshootingUse read-only evidence first, preserve recoverable state, and follow exact AIT recovery hints.
Appendix
- Appendix: Configuration FilesMap every public RC.8 AIT configuration file to its purpose, owner, mutation boundary, and detailed schema reference.
- Appendix: .ait/config.jsonThe complete current RC.8 persisted Repository configuration contract, including ownership, defaults, lifecycle writers, worktree overlays, and recovery boundaries.
- Appendix: Policy and Ignore RulesConfigure RC.8 admission requirements in .ait/policy.yaml and repository visibility in .aitignore with exact accepted fields and matching rules.
- Appendix: Patchset CI ConfigurationDefine the canonical RC.8 Patchset CI suite catalog, supported runners, checks, artifacts, and bounded local locator.
- Appendix: External Repository ConfigurationDeclare, lock, materialize, bind, and locally override external Repositories through the three RC.8 TOML contracts.
- Appendix: Agent-worker ConfigurationConfigure named Telegram, LINE, Discord, and Slack workers, credential precedence, runtime paths, transport modes, and local reply behavior.
- Appendix: Release ManifestsExpand the generic command-adapter and specialized AIT native-family release manifest schemas, bounds, and ownership rules.
- Appendix: Environment VariablesThe normalized 31-entry installed RC.8 environment contract, with explicit ownership, setting, secret, and process-boundary behavior.