Skip to main content
Every server the bot is in becomes a folder of channels, each a folder of days with a chat.jsonl of that day’s messages and the files shared in it. Members become one JSON profile each.

Setup

Create a Discord application with a bot, turn on its intents and add it to the server.
  1. Open the Discord Developer Portal, click New Application and name it (for example Mirage).
  2. Under Bot, click Reset Token and copy the bot token.
  3. On the same page, under Privileged Gateway Intents, turn on Message Content Intent; without it, message text and attachments come back empty. Turn on Server Members Intent for the members/ folder and for discord members without --query.
  4. Under OAuth2, URL Generator, select the bot scope and the View Channels and Read Message History permissions. Add Send Messages for the CLI’s writes and Attach Files for send --file.
  5. Open the generated URL in a browser and add the bot to the server.

Connect

workspace.yaml

Layout

  • A name is <display-name>__<id>, spaces and emoji kept; quote it in the shell.
  • Each channel lists one folder per day for the 30 days up to its newest message; start_time and end_time set another range.
  • A chat.jsonl line is one message as Discord’s API returns it, with .content, .author.username and .attachments.

Sample runs

The mount is read-only. Send messages with the discord CLI.

SDK guides

Python

Every config field, the VFS.md and write support.

TypeScript

Every config field, the VFS.md and write support.