fixes and init bin

2026-08-13 14:39:09 -04:00
parent 879ad78bed
commit 6434ac957a
20 changed files with 1521 additions and 16 deletions
@@ -0,0 +1,60 @@
+{
+  "name": "init-discord",
+  "section": 1,
+  "title": "init-discord",
+  "synopsis": [
+    "init-discord [--token TOKEN] [--guild ID] [--whitelist ID,ID] [--yes] [--force] [--plugin-only]"
+  ],
+  "description": "Set up the stock Discord bot on this session. Creates ~/.discord and ~/.discord/plugins, writes ~/.discord/.env (DISCORD_TOKEN, optional DISCORD_GUILD_ID and DISCORD_ID_WHITELIST), and installs the hello-world plugin ~/.discord/plugins/hello.json (/hello). Interactive by default: prompts for token, guild id, and whitelist. Never prints the full token. After setup run discord-bot --check and start bare-os-discord.",
+  "options": [
+    {
+      "flag": "--token TOKEN",
+      "meaning": "Bot token (Developer Portal → Bot → Token). Prefer the interactive prompt so it is not stored in shell history."
+    },
+    {
+      "flag": "--guild ID",
+      "meaning": "Guild id for instant slash-command registration."
+    },
+    {
+      "flag": "--whitelist ID,ID",
+      "meaning": "Comma-separated Discord user ids allowed to use the bot."
+    },
+    {
+      "flag": "--yes",
+      "meaning": "Non-interactive. Requires --token or an existing ~/.discord/.env token."
+    },
+    {
+      "flag": "--force",
+      "meaning": "Replace an existing token and overwrite hello.json."
+    },
+    {
+      "flag": "--plugin-only",
+      "meaning": "Only create ~/.discord/plugins/hello.json; do not change .env."
+    }
+  ],
+  "keywords": ["discord", "bot", "setup", "init", "plugin"],
+  "environment": [
+    "Writes DISCORD_TOKEN, DISCORD_GUILD_ID, DISCORD_ID_WHITELIST into ~/.discord/.env and the current session env."
+  ],
+  "seeAlso": [
+    {
+      "name": "discord-bot",
+      "section": 1
+    },
+    {
+      "name": "devguide-21-discord-bots",
+      "section": 7
+    }
+  ],
+  "bareOsNotes": "Guest VFS paths. The initd unit bare-os-discord appears in systemctl list only after ~/.discord/.env exists with a token.",
+  "examples": [
+    {
+      "caption": "interactive setup",
+      "code": "init-discord"
+    },
+    {
+      "caption": "scripted setup (avoid --token on a recorded TTY if you can)",
+      "code": "init-discord --yes --token \"$DISCORD_TOKEN\" --guild 123 --whitelist 456"
+    }
+  ]
+}