@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

kevin-david/discord-adapter

README