remote-opencode 1.0.1 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RoundTable02
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -38,6 +38,12 @@ The bot runs on your development machine alongside OpenCode. When you send a com
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [Discord Bot Setup](#discord-bot-setup)
+  - [Step 1: Create Discord Application](#step-1-create-discord-application)
+  - [Step 2: Create Bot & Get Token](#step-2-create-bot--get-token)
+  - [Step 3: Enable Required Intents](#step-3-enable-required-intents)
+  - [Step 4: Configure Bot Permissions](#step-4-configure-bot-permissions)
+  - [Step 5: Get Your Server (Guild) ID](#step-5-get-your-server-guild-id)
+  - [Step 6: Invite Bot to Your Server](#step-6-invite-bot-to-your-server)
 - [CLI Commands](#cli-commands)
 - [Discord Slash Commands](#discord-slash-commands)
 - [Usage Workflow](#usage-workflow)
@@ -131,7 +137,65 @@ Click **"Save Changes"**
 <!-- ![Enable Intents](./docs/images/03-intents.png) -->
 *Screenshot placeholder: Intents section with required toggles enabled*
 
-### Step 4: Get Your Server (Guild) ID
+### Step 4: Configure Bot Permissions
+
+The bot needs specific permissions to function properly. You can configure permissions in two ways:
+
+#### Option A: Using OAuth2 URL Generator (Recommended)
+
+1. Navigate to the **"OAuth2"** section in the sidebar
+2. Click on **"URL Generator"**
+3. In **"Scopes"**, select:
+   - ✅ `bot`
+   - ✅ `applications.commands`
+4. In **"Bot Permissions"**, select only these essential permissions:
+   
+   **General Permissions:**
+   - ✅ **View Channels** — Required to access channels
+   
+   **Text Permissions:**
+   - ✅ **Send Messages** — Send responses to channels
+   - ✅ **Create Public Threads** — Create threads for each `/opencode` session
+   - ✅ **Send Messages in Threads** — Reply within threads
+   - ✅ **Embed Links** — Send formatted embed messages
+   - ✅ **Read Message History** — Access context for conversations
+   - ✅ **Add Reactions** — Add buttons (uses emoji reactions internally)
+   - ✅ **Use Slash Commands** — Register and use slash commands
+
+5. Copy the generated URL at the bottom — this is your bot invite link!
+
+<!-- SCREENSHOT: OAuth2 URL Generator showing selected permissions -->
+<!-- ![OAuth2 Permissions](./docs/images/03b-oauth2-permissions.png) -->
+*Screenshot placeholder: OAuth2 URL Generator with bot permissions selected*
+
+#### Option B: Manual Permission Calculation
+
+If you're building the URL manually, use this permission value:
+
+```
+https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=343932274624&scope=bot%20applications.commands
+```
+
+**Permission Breakdown (343932274624):**
+
+| Permission | Value | Purpose |
+|------------|-------|---------|
+| View Channels | 1024 | Access channels and read messages |
+| Send Messages | 2048 | Send messages to channels |
+| Create Public Threads | 68719476736 | Create threads for each `/opencode` command |
+| Send Messages in Threads | 274877906944 | Reply within created threads |
+| Embed Links | 16384 | Send rich embed messages with formatting |
+| Read Message History | 65536 | Access previous messages for context |
+| Add Reactions | 64 | Add button components (uses emoji reactions) |
+| Use Slash Commands | 2147483648 | Register and respond to slash commands |
+
+**Optional Permissions (not required):**
+- **Attach Files** (32768) — Only if you want to upload files
+- **Mention @everyone** (131072) — Only if bot needs to ping everyone
+
+**Important:** The URL must include `applications.commands` scope for slash commands to work!
+
+### Step 5: Get Your Server (Guild) ID
 
 1. Open Discord and go to **User Settings → Advanced**
 2. Enable **"Developer Mode"**
@@ -142,12 +206,12 @@ Click **"Save Changes"**
 <!-- ![Copy Server ID](./docs/images/04-guild-id.png) -->
 *Screenshot placeholder: Right-click menu showing "Copy Server ID" option*
 
-### Step 5: Invite Bot to Your Server
+### Step 6: Invite Bot to Your Server
 
-The setup wizard generates an invite URL, or use this format:
+Use the URL generated in Step 4 (OAuth2 URL Generator), or construct it manually:
 
 ```
-https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=2147534848&scope=bot
+https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=343932274624&scope=bot%20applications.commands
 ```
 
 1. Replace `YOUR_CLIENT_ID` with your Application ID

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-opencode",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Discord bot for remote OpenCode CLI access",
   "main": "dist/src/index.js",
   "bin": {