This table lists every key tx reads from configuration files. Types refer to TOML types.
Key Type Default Description
providerstringcodexProvider used when starting a new session without a profile. Must match a key under [providers]. profilestringunset Preferred profile when creating sessions. Must match a key under [profiles]. search_modestringfirst_promptInitial search mode in the TUI. Accepts first_prompt or full_text.
Sessions the indexer marks as unactionable stay hidden from default listings but remain searchable.
Key Type Required Description
binstring✅ Executable or absolute path. flagsarray<string>Default arguments passed to the provider. envarray<string>Environment entries (KEY=value). Supports ${env:VAR} interpolation. stdin_tostringTemplate describing how to inject captured stdin into the argv list. Requires stdin_mode = "capture_arg". stdin_modestringDelivery mode: pipe (default) streams stdin; capture_arg passes stdin as an argument.
Values are shell commands executed before or after the provider. They can reference template tokens such as {{session.id}} or {{var:KEY}}.
Key Type Required Description
shellboolWhen true, invoke the wrapper via /bin/sh -c. Defaults to false. cmdstring or array<string>✅ Wrapper command. Use a string when shell = true; use an array for argv-style declarations. {{CMD}} expands to the provider command.
Key Type Required Description
providerstring✅ Provider key to run. descriptionstringLabel shown in the TUI preview. prearray<string>Ordered list of pre-snippet names. postarray<string>Ordered list of post-snippet names. wrapstringWrapper name. prompt_assemblerstringPrompt name to run through the prompt-assembler helper before launching the provider (requires [features.pa]). Missing positional arguments are requested interactively. prompt_assembler_argsarray<string>Extra arguments forwarded to the helper when prompt_assembler is set.
Key Type Default Description
enabledboolfalseEnable the integration. namespacestringpaPrefix applied to virtual profile names.
Session log roots for the codex provider live under $CODEX_HOME or fall back to ~/.codex/session[s].
Directory paths expand ~ and environment variables using shellexpand with the same rules the runtime uses.
Keys not listed here are ignored. Keep configuration minimal and additive so drop-ins compose cleanly.