discord-cli

PyPI package name: kabi-discord-cli — install with uv tool install kabi-discord-cli

中文

More Projects

• xiaohongshu-cli — Xiaohongshu (小红书) CLI for notes and account workflows
• twitter-cli — Twitter/X CLI for timelines, bookmarks, and posting
• bilibili-cli — Bilibili CLI for videos, users, search, and feeds
• tg-cli — Telegram CLI for local-first sync, search, and export

Telethon-style local-first tooling for Discord: sync messages into SQLite, search them from the terminal, export structured results, and feed them to AI agents.

discord-cli uses the Discord HTTP API with a user token from your local session. It is meant for accounts you control, on machines you control.

Warning

• discord-cli reads a Discord user token from your local Discord/browser session.
• Discord may restrict or suspend accounts that automate user-token traffic.
• Use it only on your own account and only if you understand the risk.

Features

• Local-first SQLite storage for history, sync, search, export, and analytics
• discord dc sync-all discovers accessible text channels and bootstraps from the API
• Query commands support --yaml and --json for scripting and AI agent integration
• Non-TTY stdout defaults to YAML; override with OUTPUT=yaml|json|rich|auto
• Structured output contract: SCHEMA.md

AI Agent Tip: Prefer --yaml for structured output unless a strict JSON parser is required. Use -n to limit results.

• Safer local channel resolution for search, recent, today, export, and purge

Installation

# PyPI
uv tool install kabi-discord-cli
# or
pipx install kabi-discord-cli

# From GitHub
uv tool install git+https://github.com/jackwener/discord-cli.git

# From source
git clone git@github.com:jackwener/discord-cli.git
cd discord-cli
uv sync --extra dev

Upgrade to the latest version:

uv tool upgrade kabi-discord-cli
# Or: pipx upgrade kabi-discord-cli

Tip: Upgrade regularly to avoid unexpected errors from outdated API handling.

Quick Start

# Extract and save a token from your local Discord/browser session
discord auth --save

# Verify auth
discord status
discord whoami

# Explore guilds and channels
discord dc guilds
discord dc channels <guild_id>

# Bootstrap local storage
discord dc sync-all -n 500

# Query local cache
discord today
discord recent -n 50
discord search "rust" -c general --json
discord timeline --by hour --json

Commands

Auth & Account

Discord API (discord dc ...)

Local Query

Data

Behavior Notes

• Most top-level query commands read from local SQLite, not directly from Discord.
• discord dc sync-all now bootstraps by discovering guilds and channels through the API, so it works on a fresh database.
• Channel names are resolved against the local database. If a name matches multiple channels, the CLI will stop and ask you to use a more specific name or a channel ID.

discord-cli also ships with SKILL.md for agent integration.

Development

uv sync --extra dev
uv run ruff check .
uv run python -m pytest
uv build

License

Apache-2.0