Comprehensive reference of all Qoder CLI configuration items, default values, environment variables, and file paths
This page lists all configuration groups, key fields, default values, and restart requirements for
JSON Schema is available for editor auto-completion, located in the project
settings.json, along with supported environment variables. For configuration file layering and merging rules, see Configuration Files and Application Order.
Configuration file locations:
| Level | Path |
|---|---|
| User Level | ~/.qoder/settings.json |
| Project-Level | <project>/.qoder/settings.json |
| Local Level | <project>/.qoder/settings.local.json |
schemas/settings.schema.json.
Top-Level Configurations
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
mcpServers | object | {} | Yes | MCP server configuration. See MCP reference. |
outputStyle | string | None | Yes | Active output style name. Compatible with general.outputStyle syntax, top-level takes precedence. |
language | string | None | Yes | Preferred language for AI responses (e.g., "Chinese"). |
vpcInstanceName | string | None | Yes | VPC Private Deployment instance name (CN edition only). |
agent | string | None | Yes | Agent name used by the main thread. |
enabledPlugins | object | {} | Yes | Plugin enablement mapping (plugin ID → true/false). See Plugins. |
hooks | object | {} | No | Event-based Hooks configuration. See Hooks reference. |
general (General)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
general.preferredEditor | string | None | No | Preferred editor for opening files. |
general.vimMode | boolean | false | No | Enable Vim Keybindings. |
general.defaultPermissionMode | enum | default | No | Default Permission Mode: default/accept_edits/plan/auto/bypass_permissions/dont_ask. |
general.enableAutoUpdate | boolean | true | No | Enable auto-updates. |
general.enableNotifications | boolean | false | No | Enable run event notifications. |
general.maxAttempts | number | 10 | No | Maximum retry attempts for main conversational model requests (up to 10). |
general.retryFetchErrors | boolean | true | No | Auto-retry on network request exceptions such as fetch failed. |
general.fileCheckpointing.enabled | boolean | true | Yes | Enable file checkpoints (code rollback). |
general.plan.enabled | boolean | true | Yes | Enable Plan Mode. |
general.plan.directory | string | System temp directory | Yes | Directory for storing plan artifacts. |
general.plan.modelRouting | boolean | true | No | Auto-switch models during Plan/implementation phases. |
general.sessionRetention.enabled | boolean | true | No | Enable automatic session cleanup. |
general.sessionRetention.maxAge | string | 30d | No | Automatically delete sessions older than this duration. |
general.sessionRetention.minRetention | string | 1d | No | Minimum retention period (safety lower bound). |
output (Output)
| Configuration Item | Type | Default | Description |
|---|---|---|---|
output.format | enum | text | CLI output format: text or json. |
ui (UI)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
ui.theme | string | None | No | Color theme name. |
ui.autoThemeSwitching | boolean | true | No | Auto-switch Light and Dark Theme based on terminal background. |
ui.terminalBackgroundPollingInterval | number | 60 | No | Terminal background color polling interval (seconds). |
ui.customThemes | object | {} | No | Custom theme definitions. |
ui.inlineThinkingMode | enum | full | No | inline thinking display: off/full. |
ui.dynamicWindowTitle | boolean | true | No | Update window title with Status Icon. |
ui.hideBanner | boolean | false | No | Hide Startup banner. |
ui.hideFooter | boolean | false | No | Hide Footer. |
ui.hideTips | boolean | false | No | Hide prompts. |
ui.showLineNumbers | boolean | true | No | Show Line number in conversations. |
ui.compactToolOutput | boolean | true | No | Compact display for tool output. |
ui.copyFullResponse | boolean | false | No | /copy always copies the full response. |
ui.loadingPhrases | enum | off | No | Loading display: tips/witty/all/off. |
ui.errorVerbosity | enum | low | No | Recoverable error verbosity: low/full. |
ui.customWittyPhrases | string[] | [] | No | Custom loading phrases. |
ui.footer.* | object | {} | No | Footer item configuration (items/showLabels/hideCWD/hideModelInfo, etc.). |
ui.rotatingInfoLine.enabled | boolean | true | No | Carousel info line above the input box. |
ui.rotatingInfoLine.intervalMs | number | 4000 | No | Carousel interval in milliseconds. |
ui.useAlternateBuffer | boolean | false | Yes | Use alternate buffer. |
ui.accessibility.screenReader | boolean | false | Yes | Screen Reader Mode, outputs plain text. |
ui.showMemoryUsage | boolean | false | No | Display memory usage information in the UI. |
ui.showSpinner | boolean | true | No | Show loading animation during operations. |
ui.terminalBuffer | boolean | true | Yes | Use the new Terminal Buffer architecture for rendering. |
ui.renderProcess | boolean | true | Yes | Enable Ink Render Process. |
ui.incrementalRendering | boolean | true | Yes | incremental rendering, reduces flickering but may cause rendering artifacts; only supported when ui.useAlternateBuffer is enabled. |
model / modelConfigs (Models)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
model.name | string | None | No | conversational model. |
model.reasoningEffort | enum | None | No | Reasoning Effort: disabled/off/none/low/medium/high/xhigh/max. |
model.contextWindow | number | None | No | Explicit Context Window (tokens). |
model.maxSessionTurns | number | -1 | No | Maximum turns to retain in session, -1 for unlimited. |
model.summarizeToolOutput | object | None | No | Set output summary token budget per tool. |
modelConfigs.aliases | object | Built-in | No | Model Configuration Alias presets. |
modelConfigs.customAliases | object | {} | No | Custom aliases, merged to override built-in ones. |
modelConfigs.overrides | array | [] | No | Apply configuration overrides based on matching conditions (primary key is model or alias); the most specific match takes effect. |
modelConfigs.customOverrides | array | [] | No | Custom overrides, merged and appended with built-in overrides. |
modelConfigs.customModels | array | [] | Yes | BYOK Custom Models. See Custom Models. |
context (Context)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
context.fileName | string/string[] | AGENTS.md | No | Context file names loaded into memory. |
context.importFormat | enum | None | No | Memory import format: tree/flat. |
context.discoveryMaxDirs | number | 200 | No | Maximum number of directories for Memory discovery. |
context.memoryBoundaryMarkers | string[] | ['.git'] | Yes | Boundary markers for upward memory discovery. |
context.loadMemoryFromIncludeDirectories | boolean | false | No | Load memory from Additional trusted directories. |
context.fileFiltering.respectGitIgnore | boolean | true | Yes | Follow .gitignore during search. |
context.fileFiltering.enableRecursiveFileSearch | boolean | true | Yes | Recursive search during @ reference completion. |
agentsMdExcludes | string[] | [] | Yes | Exclude project-level / local-level memory files by glob. Top-level key, supports manual configuration only. |
tools (Tools)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
tools.sandbox | boolean/string/object | None | Yes | Sandbox Execution Environment. See Sandbox. |
tools.sandboxAllowedPaths | string[] | [] | Yes | Additional accessible paths for the sandbox. |
tools.sandboxNetworkAccess | boolean | false | Yes | Whether the sandbox is allowed network access. |
tools.shell.pager | string | cat | No | Shell output paging command. |
tools.shell.inactivityTimeout | number | 300 | No | Shell no-output timeout in seconds. |
tools.core | string[] | None | Yes | Built-in tool Allowlist. |
tools.exclude | string[] | None | Yes | Tool names excluded from discovery. |
tools.useRipgrep | boolean | true | No | Use ripgrep for content search. |
tools.disableLLMCorrection | boolean | true | Yes | Disable LLM error correction for editing tools. |
mcp (MCP)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
mcp.allowed | string[] | None | Yes | Allowed MCP server list. |
mcp.excluded | string[] | None | Yes | Excluded MCP server list. |
mcp.enableAllProjectMcpServers | boolean | false | Yes | Auto-approve all project-level MCP servers. |
mcp.enabledProjectMcpServers | string[] | [] | Yes | List of individually approved project-level MCP server names. |
mcp.lazyLoad | boolean | false | Yes | Lazy load MCP tools (exposes Meta Tool). |
security (Security)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
security.folderTrust.enabled | boolean | true | Yes | Enable Folder Trust. |
security.toolSandboxing | boolean | false | Yes | tool-level sandbox isolation. |
security.disableYoloMode | boolean | false | Yes | Disable bypass_permissions (YOLO) Permission Mode. |
security.blockGitExtensions | boolean | false | Yes | Block installing/loading extensions from Git. |
security.allowedExtensions | string[] | [] | Yes | Extension source regex Allowlist. |
security.environmentVariableRedaction.enabled | boolean | false | Yes | Enable Environment Variable Masking for variables that may contain secrets. |
security.enableConseca | boolean | false | Yes | Enable context-aware security check. |
permissions (Permissions)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
permissions.allow | string[] | [] | No | List of automatically allowed permission rules. For rule syntax, see Permissions and Directory Trust. |
permissions.ask | string[] | [] | No | List of permission rules requiring confirmation. |
permissions.deny | string[] | [] | No | List of always denied permission rules. |
permissions.additionalDirectories | string[] | [] | No | Additional trusted directories added to workspace context (corresponding to /add-dir). |
permissions.trustDirectories | string[] | [] | No | Directories explicitly trusted by the user; stored in user-level configuration and not overridden by project-level configuration. |
autoMode | object | {} | No | Auto mode classifier soft-steering rules (allow/soft_deny/environment). Top-level key, read only from user-level and local configurations. |
allowManagedPermissionRulesOnly | boolean | false | No | Use only Managed Policy permission rules. Top-level key, primarily used for organizational managed policies. |
privacy / aiCodeStatistics (Privacy)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
privacy.usageStatisticsEnabled | boolean | true | No | Share usage data; turn off to enter Privacy mode. |
aiCodeStatistics.enabled | boolean | true | Yes | Record and report AI-generated code statistics. |
advanced (Advanced)
| Configuration Item | Type | Default | Restart | Description |
|---|---|---|---|---|
advanced.autoConfigureMemory | boolean | true | Yes | Auto-configure Node.js memory limit. |
advanced.dnsResolutionOrder | string | None | Yes | DNS resolution order. |
advanced.excludedEnvVars | string[] | ['DEBUG','DEBUG_MODE'] | No | Environment variables excluded from project context. |
agents.overrides | object | {} | Yes | Override configuration by Agent name (enablement, tools, models, run limits, etc.). For fields, see Subagent. |
statusLine (Status Bar)
| Configuration Item | Type | Default | Description |
|---|---|---|---|
statusLine.type | string | command | Status bar type. |
statusLine.command | string | "" | Shell command to generate the status bar, receives session data JSON via stdin. |
statusLine.padding | number | 0 | Number of horizontal padding characters. |
statusLine.colors | object | {} | Custom paragraph colors for the built-in default status bar (e.g., model, branch, separator). |
Environment Variables
Qoder-Related
| Environment Variable | Description |
|---|---|
QODER_PERSONAL_ACCESS_TOKEN | Personal Access Token (PAT). When set, PAT authentication is used automatically. |
QODER_CONFIG_DIR | User configuration directory location (default: ~/.qoder). |
QODER_MODEL | Specifies the model to use. |
QODER_WORKING_DIR | Working Directory. |
QODER_SESSION_ID | Session ID. |
QODER_SESSION_NAME | Session name. |
QODER_PERMISSION_MODE | Permission Mode. |
QODER_APPEND_SYSTEM_PROMPT | Appends to the System Prompt. |
QODER_MCP_LAZY | Enables MCP Lazy Loading when set to 1. |
QODER_SANDBOX | Sandbox command or flag. |
QODER_SANDBOX_IMAGE | Custom Sandbox Image. |
QODER_SANDBOX_IMAGE_DEFAULT | Default Sandbox Image. |
QODER_SANDBOX_PROXY_COMMAND | Internal proxy command for the sandbox. |
SANDBOX | Injected by the sandbox environment to detect if already inside a sandbox to avoid nesting (usually does not need to be set manually). |
QODER_ASR_URL | Speech recognition service URL. |
QODER_SUBAGENT_MODEL | Model used by Subagents. |
QODER_MEMORY | Enables Auto-memory when set to 1 (only applies to interactive sessions). |
QODER_MEMORY_USER | Enables user-level Auto-memory when set to 1; only takes effect when QODER_MEMORY is enabled. |
Network and Proxy
| Environment Variable | Description |
|---|---|
HTTP_PROXY / http_proxy | Proxy address for HTTP requests. |
HTTPS_PROXY / https_proxy | Proxy address for HTTPS requests. |
NO_PROXY / no_proxy | Comma-separated list of hosts to bypass the proxy. |
NODE_EXTRA_CA_CERTS | Path to an additional CA certificate file (PEM format). |
SSL_CERT_FILE | Specifies the path to a trusted certificate file for Self-Signed Certificate or Enterprise root certificate environments. |
Next Steps
- Configuration layering and merging rules: Configuration Files and Application Order.
- Network and proxy configuration: Network, Proxy, and VPC.
- Sandbox configuration: Sandbox.