Config Overrides

Pythinker Code configuration can be set through multiple methods, with different sources overriding each other by priority.

Priority

Configuration priority from highest to lowest:

1. Environment variables - Highest priority, for temporary overrides or CI/CD environments
2. CLI flags - Flags specified at startup
3. Configuration file - ~/.pythinker/config.toml or file specified via --config-file

CLI flags

Configuration file related

Flag	Description
--config <TOML/JSON>	Pass configuration content directly, overrides default config file
--config-file <PATH>	Specify configuration file path, replaces default ~/.pythinker/config.toml

--config and --config-file cannot be used together.

Model related

Flag	Description
--model, -m <NAME>	Specify model name to use

The model specified by --model must be defined in the configuration file's models. If not specified, uses default_model from the configuration file.

Behavior related

Flag	Description
--thinking	Enable thinking mode
--no-thinking	Disable thinking mode
--yolo, --yes, -y	Dangerously skip permission approvals (user still reachable for AskUserQuestion)
--auto	Auto mode (no user present): auto-approve all tool calls and auto-dismiss AskUserQuestion
--plan	Start in plan mode

--thinking / --no-thinking overrides the thinking state saved from the last session. If not specified, uses the last session's state.

--plan enables plan mode for new sessions; when resuming an existing session, it forces plan mode on. You can also set default_plan_mode = true in the config file to start new sessions in plan mode by default.

Environment variable overrides

Environment variables can override provider and model settings without modifying the configuration file. This is particularly useful in the following scenarios:

• Injecting keys in CI/CD environments
• Temporarily testing different API endpoints
• Switching between multiple environments

Environment variables take effect based on the current provider type:

• pythinker type providers: Use PYTHINKER_* environment variables
• openai_legacy, openai_responses, or openai_codex type providers: Use OPENAI_* environment variables
• Other provider types: Environment variable overrides not supported

See Environment Variables for the complete list.

Example:

PYTHINKER_API_KEY="sk-xxx" PYTHINKER_MODEL_NAME="pythinker-ai-thinking" pythinker

Configuration priority example

Assume the configuration file ~/.pythinker/config.toml contains:

default_model = "pythinker-for-coding"

[providers.pythinker-for-coding]
type = "pythinker"
base_url = "https://api.pythinker.com/coding/v1"
api_key = "sk-config"

[models.pythinker-for-coding]
provider = "pythinker-for-coding"
model = "pythinker-for-coding"
max_context_size = 262144

Here are the configuration sources in different scenarios:

Scenario	base_url	api_key	model
pythinker	Config file	Config file	Config file
PYTHINKER_API_KEY=sk-env pythinker	Config file	Environment variable	Config file
pythinker --model other	Config file	Config file	CLI flag
PYTHINKER_MODEL_NAME=pythinker-ai pythinker	Config file	Config file	Environment variable