@openacp/discord-adapter

Discord adapter plugin for OpenACP. Creates forum threads for each AI session, supports slash commands, streaming messages, and permission requests.

Installation

openacp plugin add @openacp/discord-adapter

Features

• Forum threads — each session gets its own thread in a dedicated #openacp-sessions forum channel
• Tool card embeds — agent activity rendered as Discord embeds with colored sidebar (🔵 running, 🟢 done, 🔴 error)
• Action row buttons — [🔇 Low] [📊 Medium] [🔍 High] [❌ Cancel] appear inline under the tool card while the agent is working
• Output modes — three detail levels (low/medium/high) with a 3-level cascade: session override → adapter default → global default
• Streaming messages — responses stream in real-time with debounced edits
• Permission buttons — Allow/Reject buttons for agent permission requests
• File and image support — attach files and screenshots directly in threads

Slash Commands

| Command | Description | |---------|-------------| | /new [agent] [workspace] | Create a new session | | /newchat | New session, same agent and workspace | | /cancel | Cancel the current session | | /status | Show session or system status | | /sessions | List all sessions | | /menu | Open the session control panel | | /handoff | Get a command to resume locally | | /agents | Browse available agents | | /install <name> | Install an agent | | /outputmode [low\|medium\|high\|reset] [session] | Set output detail level | | /dangerous | Toggle auto-approval of permissions | | /tts [on\|off] | Toggle text-to-speech | | /settings | Change config in-chat | | /doctor | Run diagnostics | | /help | Show help |

Output Mode

Controls how much detail is shown while the agent is working:

| Mode | Description | |------|-------------| | low | Compact icon grid — minimal noise | | medium | Tool titles, descriptions, output summaries (default) | | high | Full inline output, plan list, thinking viewer links |

Switch adapter default: /outputmode high Override per session: /outputmode session high Reset to global default: /outputmode reset

Or click the mode buttons in the tool card action row — no command needed.

Development

git clone https://github.com/Open-ACP/discord-adapter.git
cd discord-adapter
pnpm install
pnpm build
pnpm test

# Hot-reload development
openacp dev .

Configuration

After installing the plugin, run openacp plugin configure @openacp/discord-adapter to set up:

• Discord bot token
• Guild ID
• Forum channel ID