discrawl/docs/commands/tail.md

tail

Runs the live Discord Gateway tail and a periodic repair loop.

Usage

discrawl tail
discrawl tail --guild 123456789012345678
discrawl tail --repair-every 30m

What it does

• connects to the Discord Gateway with the configured bot token
• writes new messages, edits, and deletes into the local archive as they arrive
• periodically runs a repair pass to catch anything the live stream missed

Flags

• --guild <id> / --guilds <id,id> - tail a specific guild scope (default: default_guild_id, or all discovered guilds if unset)
• --repair-every <duration> - frequency of the repair sweep

Notes

• requires a working Discord bot token
• not available in Git-only mode (discord.token_source = "none")
• terminates cleanly on SIGINT / SIGTERM and treats cancellation as normal exit

See also

• sync
• Bot setup