AntigravityCliSdk.Options validates the SDK invocation contract before any
process is launched.
| Field | Type | Default | CLI mapping |
|---|---|---|---|
model | string or nil | core catalog default | Core model payload |
cli_command | string or nil | app config/PATH | Path to agy |
sandbox | boolean | false | --sandbox |
dangerously_skip_permissions | boolean | false | --dangerously-skip-permissions |
conversation | string or nil | nil | --conversation <id> |
continue | boolean | false | --continue |
add_dirs | list of strings | [] | repeatable --add-dir <path> |
print_timeout | string or nil | nil | --print-timeout <value> |
log_file | string or nil | app config or nil | --log-file <path> |
cwd | string or nil | nil | subprocess working directory |
api_key | string or nil | nil | ANTIGRAVITY_API_KEY in child env |
env | map | %{} | child env overlay |
execution_surface | struct/map/keyword | local | core execution placement |
governed_authority | struct/map/keyword or nil | nil | materialized command/cwd/env authority |
Library code reads application configuration through Application.get_env/3.
config/runtime.exs is responsible for translating OS environment variables
such as ANTIGRAVITY_CLI_PATH, ANTIGRAVITY_MODEL, and
ANTIGRAVITY_LOG_FILE into application config.
ArgBuilder always renders the prompt as ["--print", prompt] first, then
adds Antigravity-native flags. --add-dir is repeatable and is never
comma-delimited.