# cli

Captured from `/tmp/antil-docs/antil` built from the working checkout. Help is literal; internal process roles are included for completeness. No `seal` or recipe command exists in this binary.

## antil

```text
Isolated-but-shared dev stacks for parallel agents

Usage:
  antil [command]

Available Commands:
  check       Observe changed paths and required Resource permissions
  claim       Manage the current Session's Resource Claims
  completion  Generate the autocompletion script for the specified shell
  config      Inspect the effective configuration
  daemon      Run the antil daemon in the foreground (normally auto-started)
  help        Help about any command
  init        Scaffold antil.yaml from a package script for review
  logs        Print a service log or an exact Run log
  operation   Follow durable Operations
  prune       Preview retained resources; explicitly apply an exact revision to delete idle unclaimed data
  resource    Inspect and reconcile retained resource ownership
  run         Run a named OperationDefinition under the Session runner
  session     Manage the Session of this workspace
  skill       Tool-agnostic agent guidance
  status      Show Session state, evidence and handoff actions
  workspace   Create or explicitly adopt git worktrees

Flags:
  -h, --help          help for antil
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil [command] --help" for more information about a command.
```

## antil check

```text
Observe changed paths and required Resource permissions

Usage:
  antil check [flags]

Flags:
  -h, --help   help for check

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil claim upgrade

```text
Add Resource permissions with atomic holder checks

Usage:
  antil claim upgrade <resource> [flags]

Flags:
      --access string              upgrade shared to exclusive; DDL defaults to exclusive
      --expected-revision string   exact Claim/Binding revision from status or a Remedy
  -h, --help                       help for upgrade
      --idempotency-key string     retry-safe key; returns the original accepted receipt
      --permission strings         permissions to add: read, write, ddl (repeatable or comma-separated)
      --wait duration              maximum time to wait after admission (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil claim

```text
Manage the current Session's Resource Claims

Usage:
  antil claim [command]

Available Commands:
  upgrade     Add Resource permissions with atomic holder checks

Flags:
  -h, --help   help for claim

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil claim [command] --help" for more information about a command.
```

## antil config explain

```text
Show a value and its source

Usage:
  antil config explain <path> [flags]

Flags:
  -h, --help   help for explain

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil config

```text
Inspect the effective configuration

Usage:
  antil config [command]

Available Commands:
  explain     Show a value and its source

Flags:
  -h, --help   help for config

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil config [command] --help" for more information about a command.
```

## antil daemon shutdown

```text
Stop the daemon; with --stop-sessions also stop every Session's processes

Usage:
  antil daemon shutdown [flags]

Flags:
  -h, --help            help for shutdown
      --stop-sessions   also stop all session runners and their services

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil daemon

```text
Run the antil daemon in the foreground (normally auto-started)

Usage:
  antil daemon [flags]
  antil daemon [command]

Available Commands:
  shutdown    Stop the daemon; with --stop-sessions also stop every Session's processes

Flags:
  -h, --help   help for daemon

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil daemon [command] --help" for more information about a command.
```

## antil init

```text
Scaffold antil.yaml from a package script for review

Usage:
  antil init [flags]

Flags:
      --exclude-local   add .antil/ to git's local info/exclude
  -h, --help            help for init
      --script string   package script to run (default "dev")

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil logs

```text
Print a service log or an exact Run log

Usage:
  antil logs [service] [flags]

Flags:
  -h, --help         help for logs
      --run string   read the log of this exact Run in the Workspace
      --tail int     last N lines (0 = all) (default 200)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil operation cancel

```text
Stop an exact named command without ending its Session

Usage:
  antil operation cancel <run-operation-id> [flags]

Flags:
  -h, --help                     help for cancel
      --idempotency-key string   retry-safe key; returns the same control or execution
      --wait duration            maximum time to wait for completion (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil operation get

```text
Show an Operation's current state without waiting

Usage:
  antil operation get <operation-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil operation retry

```text
Explicitly retry a confirmed stopped named command

Usage:
  antil operation retry <run-operation-id> [flags]

Flags:
  -h, --help                     help for retry
      --idempotency-key string   retry-safe key; returns the same control or execution
      --wait duration            maximum time to wait for completion (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil operation wait

```text
Wait for an Operation to finish

Usage:
  antil operation wait <operation-id> [flags]

Flags:
  -h, --help            help for wait
      --wait duration   maximum time to wait (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil operation

```text
Follow durable Operations

Usage:
  antil operation [command]

Available Commands:
  cancel      Stop an exact named command without ending its Session
  get         Show an Operation's current state without waiting
  retry       Explicitly retry a confirmed stopped named command
  wait        Wait for an Operation to finish

Flags:
  -h, --help   help for operation

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil operation [command] --help" for more information about a command.
```

## antil prune

```text
Preview retained resources; explicitly apply an exact revision to delete idle unclaimed data

Usage:
  antil prune [flags]

Flags:
      --apply string             apply the exact revision returned by a reviewed preview
  -h, --help                     help for prune
      --idempotency-key string   retry-safe apply request key
      --retry string             explicitly retry the remaining exact releases of a failed/unknown prune Operation
      --wait duration            maximum wait (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil resource reconcile

```text
Release a proven-quiescent resource reservation while retaining unknown schema

Usage:
  antil resource reconcile <allocation> [flags]

Flags:
      --generation int           exact retained Allocation generation (required)
  -h, --help                     help for reconcile
      --idempotency-key string   retry-safe reconciliation key

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil resource

```text
Inspect and reconcile retained resource ownership

Usage:
  antil resource [command]

Available Commands:
  reconcile   Release a proven-quiescent resource reservation while retaining unknown schema

Flags:
  -h, --help   help for resource

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil resource [command] --help" for more information about a command.
```

## antil run

```text
Run a named OperationDefinition under the Session runner

Usage:
  antil run <operation> [flags]

Flags:
  -h, --help                     help for run
      --idempotency-key string   retry-safe key; returns the same execution
      --wait duration            maximum time to wait for command completion (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil session end

```text
Stop every process of this workspace's Session and end it (harmless to repeat)

Usage:
  antil session end [flags]

Flags:
      --abandon                  end without stopping processes antil can no longer reach
  -h, --help                     help for end
      --idempotency-key string   retry-safe key; the same key returns the same Operation
      --wait duration            how long to wait before returning status waiting (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil session resume

```text
Start a suspended Session's services again on the same ports

Usage:
  antil session resume [flags]

Flags:
  -h, --help                     help for resume
      --idempotency-key string   retry-safe key; the same key returns the same Operation
      --wait duration            how long to wait before returning status waiting (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil session start

```text
Start (or replay) the Session of this workspace

Usage:
  antil session start [stack] [flags]

Flags:
  -h, --help                     help for start
      --idempotency-key string   retry-safe key; the same key returns the same Operation
      --wait duration            how long to wait before returning status waiting (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil session suspend

```text
Stop this workspace's services but keep their ports and data

Usage:
  antil session suspend [flags]

Flags:
  -h, --help                     help for suspend
      --idempotency-key string   retry-safe key; the same key returns the same Operation
      --wait duration            how long to wait before returning status waiting (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil session touch

```text
Refresh liveness without changing ownership

Usage:
  antil session touch [flags]

Flags:
  -h, --help   help for touch

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil session

```text
Manage the Session of this workspace

Usage:
  antil session [command]

Available Commands:
  end         Stop every process of this workspace's Session and end it (harmless to repeat)
  resume      Start a suspended Session's services again on the same ports
  start       Start (or replay) the Session of this workspace
  suspend     Stop this workspace's services but keep their ports and data
  touch       Refresh liveness without changing ownership

Flags:
  -h, --help   help for session

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil session [command] --help" for more information about a command.
```

## antil skill print

```text
Usage:
  antil skill print [flags]

Flags:
  -h, --help   help for print

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil skill

```text
Tool-agnostic agent guidance

Usage:
  antil skill [command]

Available Commands:
  print       

Flags:
  -h, --help   help for skill

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil skill [command] --help" for more information about a command.
```

## antil status

```text
Show Session state, evidence and handoff actions

Usage:
  antil status [flags]

Flags:
  -h, --help              help for status
      --takeover string   record the successor controller and refresh liveness

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil workspace adopt

```text
Usage:
  antil workspace adopt [flags]

Flags:
  -h, --help   help for adopt

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil workspace create

```text
Usage:
  antil workspace create <branch> [flags]

Flags:
  -h, --help                     help for create
      --idempotency-key string   retry-safe request key
      --path string              destination checkout path (required)
      --ref string               commit or ref to start from (default "HEAD")
      --wait duration            maximum wait (default 1m0s)

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil workspace

```text
Create or explicitly adopt git worktrees

Usage:
  antil workspace [command]

Available Commands:
  adopt       
  create      

Flags:
  -h, --help   help for workspace

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope

Use "antil workspace [command] --help" for more information about a command.
```

## antil help

```text
Help provides help for any command in the application.
Simply type antil help [path to command] for full details.

Usage:
  antil help [command] [flags]

Flags:
  -h, --help   help for help

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```

## antil runner

```text
Run a session runner (internal; started by the daemon)

Usage:
  antil runner [flags]

Flags:
  -h, --help             help for runner
      --session string   session id

Global Flags:
      --home string   antil home (default $ANTIL_HOME or ~/.local/state/antil)
      --json          print the JSON envelope
```