commands

`tail`

github edit

tail

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

#Usage

discrawl tail
discrawl tail --with-embeddings
discrawl tail --guild 123456789012345678
discrawl tail --repair-every 30m
discrawl tail --replay-failures-only

#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
  • optionally queues live, replayed, and repair messages for background embedding
  • can replay a bounded set of unresolved exact-message failures without

    • starting the Gateway tail

#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
  • --with-embeddings - queue live, replayed, and repair messages for embedding (default: off)
  • --replay-failures-only - replay unresolved exact-message tail failures and exit
  • --replay-limit <n> - maximum failures to inspect in replay-only mode (default and maximum: 25)

#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
  • replay-only mode uses the normal exclusive writer lock and does not create

    • Gateway message events or update tail:last_event

#See also