Settings

Settings is accessible from the gear icon at the bottom of the left navigation bar. It has four sections: Resources, Proxy, CLI Tools, and Preferences.

---

Resources

The Resources page lists every AI provider extension that is installed. Each provider appears as a card. The right column of each card shows the named connections that have already been configured for that provider, or a Create new ... button to configure it for the first time.

Provider extensions available:

Provider	What it connects to
Claude	Anthropic Claude API
Container	Container registry for sandbox images
Cursor	Cursor API
Docling	Docling document parser (used by Knowledges)
Gemini	Google Gemini API
Milvus	Milvus / Zilliz vector database (used by Knowledges)
Mistral	Mistral AI API
Ollama	Local Ollama inference server
OpenAI	OpenAI API (or any OpenAI-compatible endpoint)
OpenShift AI	Red Hat OpenShift AI cluster
RamaLama	Local RamaLama inference server
Vertex AI	Google Cloud Vertex AI

Configured connections appear alongside the provider card with a delete icon. To manage the full detail of an extension — including API keys, base URLs, and model selection — click through to Extensions in the main navigation.

---

Proxy

Proxy settings apply to outbound traffic from Kaiden itself (not from sandboxes — sandbox network policy is set per project).

• Proxy configuration — shows the current proxy source. The default value is System, meaning Kaiden reads the OS proxy settings.
• Web Proxy (HTTP) — override the HTTP proxy URL. Leave blank to use the system value.
• Secure Web Proxy (HTTPS) — override the HTTPS proxy URL. Leave blank to use the system value.
• Bypass proxy settings for these hosts and domains — comma-separated hostnames and CIDR ranges that skip the proxy (default: local,169.254/16).

Click Update to apply changes.

---

CLI Tools

Shows the OpenShell binaries bundled with Kaiden and their versions.

Binary	Description
openshell	OpenShell CLI for managing sandboxed workspaces
openshell-image-builder	CLI for building custom container images for OpenShell sandboxes
openshell-gateway	OpenShell Gateway server for managing sandbox connections

Each entry shows the detected version and a delete icon. The bundled binaries are updated with Kaiden releases. To use a custom build, configure a custom path under Preferences → Extension: OpenShell.

---

Preferences

Preferences has a search field and a set of sub-sections accessible from the left sub-navigation:

Agent Workspace

• Runtime — override the container runtime used when creating agent workspaces.
• Default Base Image — default sandbox image used when the agent does not request a specific one.

Appearance

• Appearance — choose between light mode, dark mode, or system setting.
• Zoom Level — adjust UI zoom. Positive values zoom in (e.g. 1 = 20% larger), negative values zoom out. Accepts decimals for fine control.
• Navigation Bar Layout — show icon and label, or icon only, in the navigation bar.

Chat

• Show Chat Window — show or hide the chat panel.
• Max Attachment File Size — maximum size in MB for file attachments in chat.

Docker Compatibility

Docker socket compatibility settings. Controls how Kaiden interacts with Docker when it is installed alongside Podman.

Editor

Settings for the built-in code editor.

Exit On Close

Controls whether Kaiden quits or minimises when the window is closed.

Extension: OpenShell

Custom binary paths for the OpenShell toolchain. Leave blank to use the bundled versions shown in CLI Tools.

• Path — custom path to the openshell binary.
• Path — custom path to the openshell-image-builder binary.
• Path — custom path to the openshell-gateway binary.
• Path — custom path to the MXC wxc-exec binary (Windows only).
• Resolution — the binary resolution order: a custom path set here is always checked first before the bundled binary, regardless of other settings.
• Gateway Poll Interval — interval in seconds between OpenShell gateway state checks (default: 5).

Extensions

Settings that apply across all installed extensions.

Feedback dialog

• Dialog — whether to show the feedback dialog when using experimental features.

Kubernetes

Kubernetes cluster connection settings.

MCP

Model Context Protocol server management. Controls the MCP registry and installed MCP servers.

Minimize on login / Start on login

Controls whether Kaiden launches at login and whether it starts minimised.

Onboarding

Re-run or reset the onboarding flow.

Registries

Container registry configuration. Manage the registries Kaiden uses when pulling sandbox images.

Skills

Agent skill management settings. Controls how skills are discovered and managed.

Tasks

Background task settings.

Telemetry

Controls whether anonymous usage data is collected. Disable this if you prefer not to send telemetry.

Terminal

Settings for the built-in terminal emulator.

Tray Icon Color

Customize the system tray icon color (Linux and Windows).

User Confirmation

Controls whether Kaiden asks for confirmation before potentially destructive actions.

Window

Controls whether Kaiden saves and restores its window position and size between sessions.