| name | discord |
| description | Send native voice messages and text to Discord channels via the discord CLI. Use when sending audio as a Discord voice message or checking channel config. |
| allowed-tools | Bash(discord:*) |
| argument-hint | send-voice-message --channel <id> --audio <path> | reply --channel <id> --message <text> |
discord — Native Voice Messages & Channel Messaging
Sends audio files as native Discord voice messages (with playback bar and waveform) and text messages to configured channels.
Config: ~/.alluka/channels/discord.json — same file used by the orchestrator daemon notifier.
When to Use
- User wants to send an audio file to Discord as a voice message
- User wants to verify Discord channel config is working
- After
elevenlabs generate, pass the output as a voice message
Commands
send-voice-message
Send an audio file as a native Discord voice message. Handles MP3 → OGG/Opus conversion, waveform generation, and the three-step upload flow automatically.
discord send-voice-message --channel <channel-id> --audio /path/to/audio.mp3
discord send-voice-message --channel <channel-id> --audio /path/to/audio.ogg --json
Supported input formats: mp3, ogg, wav, m4a, webm (any format ffmpeg can decode)
Requirements: ffmpeg in PATH (brew install ffmpeg)
reply
Send a plain text message to a Discord channel.
discord reply --channel <channel-id> --message "Hello from nanika"
discord reply --channel <channel-id> --message "Mission complete" --json
query
JSON-native subcommands for dashboard and agent use.
discord query status --json
discord query items --json
discord query actions --json
doctor
Verify ffmpeg availability and config.
discord doctor
discord doctor --json
Config Format
~/.alluka/channels/discord.json:
{
"bot_token": "<your-bot-token>",
"channel_ids": ["<channel-id>"]
}
Examples
User: "send this audio to Discord"
Action: discord send-voice-message --channel <id> --audio /path/to/audio.mp3
User: "generate a voice message and send to Discord"
Action:
elevenlabs generate narration.txt --output /tmp/
discord send-voice-message --channel <id> --audio /tmp/narration.mp3