Agent providers
Connect installed coding agents through their ACP adapters and choose settings for each conversation.
Configure the host account
ACPDash launches provider processes as the account running the host. Install and authenticate the provider under that account before starting a conversation. Check that its executable is available on the host’s PATH.
The dashboard does not replace the provider’s authentication flow. Follow the chosen provider’s own installation and sign-in instructions, then verify it can run from a terminal on the host.
Supported adapters
| Provider | Default launch | Executable override |
|---|---|---|
| Codex | Bundled codex-acp adapter, with codex on PATH |
ACPDASH_CODEX or ACPDASH_CODEX_ACP |
| Claude | Bundled claude-agent-acp adapter |
ACPDASH_CLAUDE or ACPDASH_CLAUDE_ACP |
| Grok | grok |
ACPDASH_GROK |
| Cursor | cursor-agent acp |
ACPDASH_CURSOR or ACPDASH_CURSOR_ACP |
| OpenCode | opencode acp |
ACPDASH_OPENCODE or ACPDASH_OPENCODE_ACP |
The root package installs the Codex and Claude adapter packages. Other executables must be available separately. Overrides are useful when an executable is outside the service’s PATH or when you need a particular adapter build.
Choose agent settings
Repository defaults provide an initial provider, model, effort, and permissions policy. Conversation controls expose the settings advertised by the selected provider. Available options vary by provider and installed version.
Pause work before changing settings that should apply to a resumed run. The dashboard distinguishes requested settings from provider-applied settings; do not assume every provider supports the same options.
Background-service credentials
A provider that works in your interactive shell may still fail in a background service if its executable or credentials are unavailable there. Check the service account, stored environment, and logs.
The service environment is stored in ~/.config/acpdash/environment. Foreground runs use the shell environment instead. See configuration and troubleshooting.