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 supports eight AI coding agent providers: Codex, Claude, Gemini, Grok, Cursor, OpenCode, Kilo, and Pi. Each provider has its own block under settings.providers in ~/.dpcode/userdata/settings.json. You can configure providers directly in that file or use the in-app Settings UI under the Providers section.
All provider blocks share a common set of base fields. Several providers add extra fields for things like home directories, API endpoints, or server URLs.
Common fields
Every provider block accepts the following fields:
| Field | Type | Default | Description |
|---|
enabled | boolean | true | Whether this provider is available for use in DP Code |
binaryPath | string | Provider-specific (see below) | Path to the provider’s CLI binary. Use an absolute path or a name resolvable on $PATH |
customModels | string[] | [] | Additional model slugs to offer in the model picker, beyond the built-in list |
Providers
codex
The Codex provider runs OpenAI’s Codex CLI (codex app-server).
| Field | Default | Description |
|---|
binaryPath | "codex" | Path to the codex binary |
homePath | "" | Override the home directory passed to the Codex process. Useful for isolating Codex state |
customModels | [] | Extra model slugs for the model picker |
enabled | true | Enable or disable Codex |
{
"providers": {
"codex": {
"binaryPath": "codex",
"homePath": "",
"customModels": [],
"enabled": true
}
}
}
claudeAgent
The Claude provider wraps the claude CLI from Anthropic.
| Field | Default | Description |
|---|
binaryPath | "claude" | Path to the claude binary |
launchArgs | "" | Extra command-line arguments appended when launching the Claude process |
customModels | [] | Extra model slugs for the model picker |
enabled | true | Enable or disable Claude |
{
"providers": {
"claudeAgent": {
"binaryPath": "claude",
"launchArgs": "--verbose",
"customModels": [],
"enabled": true
}
}
}
gemini
The Gemini provider wraps the gemini CLI from Google.
| Field | Default | Description |
|---|
binaryPath | "gemini" | Path to the gemini binary |
customModels | [] | Extra model slugs for the model picker |
enabled | true | Enable or disable Gemini |
{
"providers": {
"gemini": {
"binaryPath": "gemini",
"customModels": [],
"enabled": true
}
}
}
grok
The Grok provider wraps the grok CLI from xAI.
| Field | Default | Description |
|---|
binaryPath | "grok" | Path to the grok binary |
customModels | [] | Extra model slugs for the model picker |
enabled | true | Enable or disable Grok |
{
"providers": {
"grok": {
"binaryPath": "grok",
"customModels": [],
"enabled": true
}
}
}
cursor
The Cursor provider integrates with Cursor’s agent binary.
| Field | Default | Description |
|---|
binaryPath | "cursor-agent" | Path to the cursor-agent binary |
apiEndpoint | "" | Custom API endpoint URL. Leave empty to use the default Cursor endpoint |
customModels | [] | Extra model slugs for the model picker |
enabled | true | Enable or disable Cursor |
{
"providers": {
"cursor": {
"binaryPath": "cursor-agent",
"apiEndpoint": "",
"customModels": [],
"enabled": true
}
}
}
opencode
The OpenCode provider connects to an OpenCode server instance.
| Field | Default | Description |
|---|
binaryPath | "opencode" | Path to the opencode binary |
serverUrl | "" | URL of the OpenCode server. Leave empty to let DP Code manage a local server |
serverPassword | "" | Password for the OpenCode server if authentication is required |
customModels | [] | Extra model slugs for the model picker |
enabled | true | Enable or disable OpenCode |
{
"providers": {
"opencode": {
"binaryPath": "opencode",
"serverUrl": "",
"serverPassword": "",
"customModels": [],
"enabled": true
}
}
}
kilo
The Kilo provider connects to a Kilo server instance. Its settings mirror those of OpenCode.
| Field | Default | Description |
|---|
binaryPath | "kilo" | Path to the kilo binary |
serverUrl | "" | URL of the Kilo server |
serverPassword | "" | Password for the Kilo server if authentication is required |
customModels | [] | Extra model slugs for the model picker |
enabled | true | Enable or disable Kilo |
{
"providers": {
"kilo": {
"binaryPath": "kilo",
"serverUrl": "",
"serverPassword": "",
"customModels": [],
"enabled": true
}
}
}
pi agent binary.
| Field | Default | Description |
|---|
binaryPath | "pi" | Path to the pi binary |
agentDir | "" | Directory used by the Pi agent for its working files |
customModels | [] | Extra model slugs for the model picker |
enabled | true | Enable or disable Pi |
{
"providers": {
"pi": {
"binaryPath": "pi",
"agentDir": "",
"customModels": [],
"enabled": true
}
}
}
Full providers example
The following snippet shows a settings.json with several providers configured:
{
"providers": {
"codex": {
"binaryPath": "/usr/local/bin/codex",
"enabled": true
},
"claudeAgent": {
"binaryPath": "claude",
"launchArgs": "",
"enabled": true
},
"gemini": {
"enabled": false
},
"grok": {
"enabled": false
},
"cursor": {
"binaryPath": "cursor-agent",
"apiEndpoint": "https://api.cursor.sh",
"enabled": true
},
"opencode": {
"binaryPath": "opencode",
"serverUrl": "http://localhost:4000",
"serverPassword": "secret",
"enabled": true
},
"kilo": {
"enabled": false
},
"pi": {
"enabled": false
}
}
}
Configuring providers in-app
You can configure every provider setting from the Providers panel in the DP Code Settings UI without editing settings.json by hand. Changes take effect immediately and are written atomically to disk.
If a provider binary cannot be found on $PATH and no absolute binaryPath is set, DP Code will fail to start sessions for that provider. Verify the binary is installed and accessible before enabling it.
Use customModels to surface models that are available via your provider account but not yet in DP Code’s built-in list. Add the model slug exactly as the provider’s CLI expects it.
