Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Emanuele-web04/dpcode/llms.txt

Use this file to discover all available pages before exploring further.

DP Code stores server-authoritative settings in ~/.dpcode/userdata/settings.json. These settings control server-side behavior such as assistant streaming, thread environments, and provider configuration. You can edit the file directly or use the in-app Settings UI — both methods persist to the same file.
If settings.json contains invalid JSON or fails schema validation, DP Code logs a warning and falls back to all defaults. Check your server logs if a setting does not appear to take effect.

​
File location

~/.dpcode/userdata/settings.json
The file is created automatically on first launch. Missing fields default to the values documented below.

​
Top-level fields

​
enableAssistantStreaming

Type: boolean — Default: false Controls whether assistant responses are streamed token-by-token to the browser as they arrive. When set to false, the full response is buffered server-side before being forwarded to the client. 
{
  "enableAssistantStreaming": true
}

​
defaultThreadEnvMode

Type: "local" | "worktree" — Default: "local" Sets the default environment mode for new threads. Use "local" to run agents against the working tree of the project directly. Use "worktree" to spin up a Git worktree per thread, keeping each agent session isolated. 
{
  "defaultThreadEnvMode": "worktree"
}

​
addProjectBaseDirectory

Type: string — Default: "" A path prefix that DP Code prepends when resolving project directories. Leave empty to use project paths as-is. Useful when all your projects share a common root (for example /home/you/work). 
{
  "addProjectBaseDirectory": "/home/you/work"
}

​
textGenerationModelSelection

Type: { provider, model } — Default: { "provider": "codex", "model": "gpt-5.4-mini" } The model used for short text generation tasks such as producing Git commit messages. This is separate from the model used for interactive coding sessions.
FieldDescription
providerProvider key ("codex", "claudeAgent", "gemini", "grok", "kilo", "opencode", "cursor", "pi")
modelModel slug understood by the selected provider
If the specified provider is disabled, DP Code automatically falls back to the first enabled provider in the following order: codex → claudeAgent → gemini → kilo → opencode. 
{
  "textGenerationModelSelection": {
    "provider": "claudeAgent",
    "model": "claude-haiku-4-5"
  }
}

​
providers

Type: object Provider-specific configuration such as binary paths, launch arguments, and custom model lists. Each key corresponds to a supported provider. See the Providers configuration page for the full reference. 
{
  "providers": {
    "codex": {
      "binaryPath": "codex",
      "enabled": true
    }
  }
}

​
Example settings.json

The following snippet shows a complete settings file with several fields customised: 
{
  "enableAssistantStreaming": true,
  "defaultThreadEnvMode": "worktree",
  "addProjectBaseDirectory": "/home/you/projects",
  "textGenerationModelSelection": {
    "provider": "codex",
    "model": "gpt-5.4-mini"
  },
  "providers": {
    "codex": {
      "binaryPath": "codex",
      "enabled": true
    },
    "claudeAgent": {
      "binaryPath": "claude",
      "enabled": true
    },
    "gemini": {
      "enabled": false
    }
  }
}

​
Editing settings in-app

You can change all of these settings without touching the file directly. Open the Settings panel from the DP Code sidebar. Changes are written atomically to disk and take effect immediately — no restart required.
Use the in-app Settings UI if you are unsure of the exact field names or valid values. It validates your input before saving.

Build docs developers (and LLMs) love

Get started for freeTalk to us