# Caspian Connect Discord

> Connect Caspian Discord for OpenCode (install OAuth or BYO bot token), enable discord in caspian.json channels, and tell the user to restart. Use when linking Discord or running /caspian:connect-discord.

- Skill: `trycaspian/caspian-connect-discord` (Agent Skill)
- Install (CLI): `npx skillmds@latest add trycaspian/caspian-connect-discord`
- Raw SKILL.md: https://api.skillmd.com/api/skills/trycaspian/caspian-connect-discord/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: Apache-2.0
- Author: trycaspian (https://skillmd.com/u/trycaspian)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/trycaspian/caspian-connect-discord

---


# Caspian connect Discord

Connect Discord to Caspian and enable `discord` in the plugin admit list
(`channels` in `~/.config/opencode/caspian.json`). Without `discord` in
`channels`, Discord events are rejected at admit (blast-radius wall).

Connect is **non-CP** (failures must not kill the email/telegram listen loop).
Admit reload requires **restart OpenCode**.

## When to use

- User asks to connect Discord
- User runs `/caspian:connect-discord` or `/caspian-connect-discord`

## How

1. Call **`caspian_connections`**.
2. Call **`caspian_connect_discord`**.
   - Default: one-click `installDiscord()` if no `DISCORD_BOT_TOKEN`
   - Or BYO: `DISCORD_BOT_TOKEN` in `.env` / `caspian.env`
   - `preferInstall: true` forces OAuth install even with a token
3. If an **Authorize URL** is returned, tell the user to open it and invite
   the bot to their server. Wait until connection status is `active`.
4. If **RESTART REQUIRED**, say clearly:

   > Restart OpenCode so admit loads `discord` in `channels`. Until then,
   > Discord messages are rejected at the blast-radius wall.

5. Never store the bot token in `caspian.json`.