Skip to main content

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:

ProviderWhat it connects to
Vertex AIGoogle Cloud Vertex AI
RamaLamaLocal RamaLama inference server
OpenShift AIRed Hat OpenShift AI cluster
OpenAIOpenAI API (or any OpenAI-compatible endpoint)
OllamaLocal Ollama inference server
MistralMistral AI API
MilvusMilvus / Zilliz vector database (used by Knowledges)
GeminiGoogle Gemini API
DoclingDocling document parser (used by Knowledges)
CursorCursor API
ContainerContainer registry for sandbox images
ClaudeAnthropic Claude API

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 (e.g. http://myproxy.domain.com:8080). 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.

BinaryDescription
openshellOpenShell CLI for managing sandboxed workspaces
openshell-image-builderCLI for building custom container images for OpenShell sandboxes
openshell-gatewayOpenShell 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.

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.
  • Resolution — the binary resolution order: a custom path set here is always checked first before the bundled binary, regardless of other settings.
  • Poll Interval — interval in seconds between OpenShell gateway state checks.

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.

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.

Tasks​

Background task settings.

Docker Compatibility​

Settings for Docker compatibility mode, allowing Kaiden to work with Docker-based container workflows alongside Podman.

MCP​

Settings for Model Context Protocol (MCP) server management and registries.

Registries​

Configure container image registries for pulling sandbox images and other container resources.

Skills​

Manage agent skill defaults and skill discovery settings.

Telemetry​

Control whether Kaiden collects anonymous usage telemetry data.

Terminal​

Settings for the built-in terminal emulator, including font and shell configuration.

Tray Icon Color​

Customize the system tray icon color to match your desktop theme.

User Confirmation​

Control whether Kaiden shows confirmation dialogs before performing potentially destructive actions.

Window​

Configure window position and size behavior, such as whether Kaiden remembers its window position between sessions.