Configuration
A program configures a run in three places: command-line flags on each call, settings files, and environment variables.
Flags for one run
| Flag | Effect |
|---|---|
-p / --print | One task, printed answer, exit. |
--output-format text|json|stream-json | Shape of the output. stream-json needs --verbose. |
--input-format stream-json | Read user messages as JSON lines from standard input. |
--max-turns <n> | Stop after n turns. |
--max-budget-usd <amount> | Stop when the run spends the amount. |
--permission-mode <mode> | default, acceptEdits, auto, plan, dontAsk, bypass (bypassPermissions is also accepted). See Permission modes. |
--allowed-tools / --disallowed-tools | Allow or remove named tools for the run. |
--system-prompt / --append-system-prompt | Replace or extend the system prompt. File forms: --system-prompt-file, --append-system-prompt-file. |
--mcp-config <file> / --strict-mcp-config | Load MCP servers from a file; with strict, use only that file. |
--settings <file> | Load one extra settings file. |
--fallback-model <model> | Model to use when the primary model is overloaded. |
--resume [id], --continue, --fork-session, --session-id <id> | Session selection. See Sessions. |
--json-schema <schema|file> | Require the final answer to be JSON that matches the schema. See Structured outputs. |
--tools <list> | Limit the built-in tools to a list. "" turns them all off. |
--agents <json|file> / --agent <name> | Define agents for this run, and run the main session as one agent. See Subagents for programs. |
--permission-prompt-tool stdio|<mcp tool> | Send approval questions to the driving program or to an MCP tool. See Permissions for programs. |
Settings files
Settings are read from the user folder and from the project’s .syntic folder. A project file cannot choose a permissive permission mode. See Settings for the file locations and keys.
Environment variables
| Variable | Effect |
|---|---|
SYNTIC_API_KEY | Sign in without the interactive login. |
SYNTIC_DATA_DIR | Location of the application data folder, including session transcripts. |
SYNTIC_BASH_SANDBOX | Turn the Bash sandbox on or off. See Sandboxing. |
The full list is in Environment variables.