skip to content
early access · antil is not publicly available yet and commands may change · join the waitlist

the antil field manual reference

cli

view markdown

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

Section titled “antil”
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

Section titled “antil check”
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

Section titled “antil claim upgrade”
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

Section titled “antil claim”
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

Section titled “antil config explain”
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

Section titled “antil config”
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

Section titled “antil daemon shutdown”
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

Section titled “antil daemon”
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

Section titled “antil init”
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

Section titled “antil logs”
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

Section titled “antil operation cancel”
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

Section titled “antil operation get”
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

Section titled “antil operation retry”
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

Section titled “antil operation wait”
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

Section titled “antil operation”
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

Section titled “antil prune”
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

Section titled “antil resource reconcile”
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

Section titled “antil resource”
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

Section titled “antil run”
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

Section titled “antil session end”
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

Section titled “antil session resume”
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

Section titled “antil session start”
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

Section titled “antil session suspend”
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

Section titled “antil session touch”
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

Section titled “antil session”
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

Section titled “antil skill print”
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

Section titled “antil skill”
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

Section titled “antil status”
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

Section titled “antil workspace adopt”
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

Section titled “antil workspace create”
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

Section titled “antil workspace”
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

Section titled “antil help”
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

Section titled “antil runner”
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