User-visible flags reference
The flags you'll actually use day-to-day across `syntax` and `syntax-cli`.
This page lists the user-visible flags you'll see across the two Syntax binaries:
syntax— the application command (connect,disconnect,deploy,doctor,models,sessions,memory).syntax-cli— the bundled coding harness (interactive TUI and theexecsubcommand for headless runs).
For the authoritative flag list, run <command> --help directly —
that output reflects the actual flags shipped in your installed
version.
Placeholders use ALL_CAPS to avoid conflicts with command-line angle
brackets in tables — e.g., --model ID means "supply a model ID
where ID is shown".
Global flags
These work on both syntax and syntax-cli:
| Flag | Meaning |
|---|---|
--version | Print the running Syntax version. |
--help, -h | Subcommand-specific help. |
--quiet | Suppress non-essential output. |
--verbose | Extra output (without enabling tracing). |
--no-color | Disable color in terminal output. |
syntax-cli (interactive harness)
| Flag | Meaning |
|---|---|
--resume | Resume a recent session. |
--model ID | Override the default model for this session. |
--mode MODE | Start in a specific Runtime Mode (default, autoedit, or bypass). Bypass still requires interactive confirmation. |
--plan | Start in Plan Mode. |
--no-color | Disable color. |
syntax-cli exec (headless)
| Flag | Meaning |
|---|---|
--input PATH | Read the task from a file instead of the command line. |
--output PATH | Write structured output to a file. |
--model ID | Override the default model. |
--max-turns N | Cap the number of agent turns. |
--policy PATH | Load an approval policy from a file. |
--json | Emit structured JSON output (for piping). |
syntax connect
| Flag | Meaning |
|---|---|
list | List currently connected harnesses. |
--dry-run | Print what would change without modifying anything. |
syntax deploy
| Flag | Meaning |
|---|---|
--target TARGET | Deployment target: local, self-managed-remote, or managed-remote. |
--tier TIER | Deployment tier: performance or cost-optimized. |
--expose-private | Issue a private exposed bearer. |
--expose-public | Issue a public exposed bearer. |
--profile NAME | Use a saved party profile. |