Dash BotDocs
Getting started

Configuration

Understand engine paths, credentials, and the local configuration boundary.

Most users configure Dash Bot from the app. The packaged desktop validates credentials before saving them and stores supported secrets with the operating system's secure storage.

Engine discovery

Dash Bot checks the inherited process path, common install locations, and the login shell. If an engine is installed somewhere unusual, open Settings → Engines and choose its executable explicitly.

Explicit paths are useful when you:

  • keep multiple CLI versions;
  • use a wrapper script;
  • installed an engine in a directory desktop apps cannot discover; or
  • launch Dash Bot from a Windows shortcut or Linux application menu with a different environment from your terminal.

Optional credentials

CredentialEnables
Composio project keyConnected apps and OAuth sessions
Box API keyHosted Linux computers
ElevenLabs API keySpoken replies and voice mode
OpenCode Go API keyOpenCode Go engine

Local agent chat works without these credentials.

Environment configuration

Source and headless runs can set supported environment variables before starting the harness. The app-level settings are preferable for normal packaged use because they validate inputs and keep secret values out of the renderer.

Do not put secrets in prompts

A prompt becomes conversation history and may be sent to an agent provider. Use App Settings or environment configuration for credentials.

On this page