# Options

`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.