agent-cli-discord is a standalone, JSON-speaking CLI that lets coding agents participate in explicitly authorized Discord guild channels through a Discord Application bot identity. It uses Discord REST API v10 only; no Gateway connection, no daemon.
Platform
Linux amd64 only for this release, as a statically linked executable (CGO_ENABLED=0). Other platforms build from source with the command in the README.
Commands
agent-cli-discord version
agent-cli-discord auth check
agent-cli-discord channels list
agent-cli-discord messages read --channel ID [--limit N] [--before ID|--after ID|--around ID]
agent-cli-discord messages get --channel ID --message ID
agent-cli-discord messages post --channel ID [--file PATH] [--attach PATH ...]
agent-cli-discord messages reply --channel ID --message ID [--file PATH] [--attach PATH ...]
agent-cli-discord reactions add --channel ID --message ID --emoji EMOJI
agent-cli-discord reactions remove --channel ID --message ID --emoji EMOJI
agent-cli-discord threads list
agent-cli-discord threads create --channel PARENT_ID --name NAME [--auto-archive MINUTES]
agent-cli-discord threads join --thread ID
agent-cli-discord threads leave --thread ID
Output contract: docs/json-contract.md. Configuration and bot permissions: README.md.
Verify the download
sha256sum -c SHA256SUMS
./agent-cli-discord-linux-amd64 versionExpected version output: {"ok":true,"data":{"name":"agent-cli-discord","version":"v1.0.0","schema_version":"1"}}
Build provenance
- Commit:
3438210521fea635ea98830e7628ea0ab935a9ea - Build:
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath ./cmd/agent-cli-discordfrom a clean checkout of tagv1.0.0with Go 1.27.1. The build is reproducible; rebuilding the tag yields the same checksum. agent-cli-discord-linux-amd64SHA-256:22608f089cbfa40e39e8024928858ba0146354fc4f777c83c5eab9d9ecf09115
Testing
Local unit and HTTP-fixture tests, race detector, and go vet pass on the release commit. The published file was live-tested against a dedicated Discord guild per docs/live-testing.md (run live-20260906T140531Z, verdict PASS, every command exercised including denied-channel and thread-allowlist cases).