SDKConfiguration

Configuration

A program configures a run in three places: command-line flags on each call, settings files, and environment variables.

Flags for one run

FlagEffect
-p / --printOne task, printed answer, exit.
--output-format text|json|stream-jsonShape of the output. stream-json needs --verbose.
--input-format stream-jsonRead 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-toolsAllow or remove named tools for the run.
--system-prompt / --append-system-promptReplace or extend the system prompt. File forms: --system-prompt-file, --append-system-prompt-file.
--mcp-config <file> / --strict-mcp-configLoad 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

VariableEffect
SYNTIC_API_KEYSign in without the interactive login.
SYNTIC_DATA_DIRLocation of the application data folder, including session transcripts.
SYNTIC_BASH_SANDBOXTurn the Bash sandbox on or off. See Sandboxing.

The full list is in Environment variables.