remote-opencode 1.0.4 → 1.0.7

package/README.md

@@ -42,12 +42,6 @@ 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)
@@ -104,95 +98,30 @@ That's it! Now use Discord slash commands to interact with OpenCode.
 
 ## Discord Bot Setup
 
-Before using remote-opencode, you need to create a Discord Application and Bot. The setup wizard will guide you, but here's a visual walkthrough:
+The setup wizard (`remote-opencode setup`) guides you through the entire process interactively:
 
-### Step 1: Create Discord Application
+1. **Opens Discord Developer Portal** in your browser
+2. **Walks you through** creating an application, enabling intents, and getting your bot token
+3. **Generates the invite link** automatically and opens it in your browser
+4. **Deploys slash commands** to your server
 
-1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
-2. Click **"New Application"**
-3. Enter a name (e.g., "Remote OpenCode")
-4. Copy the **Application ID** — you'll need this later
+Just run `remote-opencode setup` and follow the prompts — no manual URL copying needed!
 
-<img width="800" alt="image" src="https://github.com/user-attachments/assets/ca2e7ff3-91e7-4d66-93dc-c166189c0107" />
+<details>
+<summary>📖 Manual setup reference (click to expand)</summary>
 
-### Step 2: Create Bot & Get Token
+If you prefer manual setup or need to troubleshoot:
 
-1. Navigate to the **"Bot"** section in the sidebar
-2. Click **"Reset Token"** (or "View Token" if available)
-3. **Copy the token immediately** — it's only shown once!
-4. Keep this token secret — never share it publicly
-
-
-### Step 3: Enable Required Intents
-
-Still in the **"Bot"** section, scroll down to **"Privileged Gateway Intents"** and enable:
-
-- ✅ **SERVER MEMBERS INTENT**
-- ✅ **MESSAGE CONTENT INTENT**
-
-Click **"Save Changes"**
-
-<img width="1500" alt="image" src="https://github.com/user-attachments/assets/d20406ff-26ad-4204-9771-b157c340846a" />
-
-### 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!
-
-
-#### 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=311385214016&integration_type=0&scope=bot+applications.commands
-```
-
-**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"**
-3. Right-click on your server name in the sidebar
-4. Click **"Copy Server ID"**
-
-<img width="184" height="530" alt="스크린샷 2026-02-03 오전 2 34 31" src="https://github.com/user-attachments/assets/8ecc2a28-05e5-494f-834f-95d9d0e4e730" />
-
-### Step 6: Invite Bot to Your Server
-
-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=218900185540&scope=bot%20applications.commands
-```
-
-1. Replace `YOUR_CLIENT_ID` with your Application ID
-2. Open the URL in your browser
-3. Select your server and authorize
+1. **Create Application**: Go to [Discord Developer Portal](https://discord.com/developers/applications), create a new application
+2. **Enable Intents**: In "Bot" section, enable SERVER MEMBERS INTENT and MESSAGE CONTENT INTENT
+3. **Get Bot Token**: In "Bot" section, reset/view token and copy it
+4. **Get Guild ID**: Enable Developer Mode in Discord settings, right-click your server → Copy Server ID
+5. **Invite Bot**: Use this URL format:
+   ```
+   https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=2147534848&scope=bot+applications.commands
+   ```
 
+</details>
 
 ---
 

package/dist/src/cli.js

@@ -2,12 +2,14 @@
 import { Command } from 'commander';
 import pc from 'picocolors';
 import { createRequire } from 'module';
+import updateNotifier from 'update-notifier';
 import { runSetupWizard } from './setup/wizard.js';
 import { deployCommands } from './setup/deploy.js';
 import { startBot } from './bot.js';
 import { hasBotConfig, getConfigDir } from './services/configStore.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../../package.json');
+updateNotifier({ pkg }).notify({ isGlobal: true });
 const program = new Command();
 program
     .name('remote-opencode')

package/dist/src/setup/wizard.js

@@ -1,8 +1,11 @@
 import * as p from '@clack/prompts';
 import pc from 'picocolors';
+import open from 'open';
 import { setBotConfig, getBotConfig, hasBotConfig } from '../services/configStore.js';
 import { deployCommands } from './deploy.js';
 const DISCORD_DEV_URL = 'https://discord.com/developers/applications';
+const BOT_PERMISSIONS = '2147534848';
+const BOT_SCOPES = 'bot applications.commands';
 function validateApplicationId(value) {
     if (!value)
         return 'Application ID is required';
@@ -24,6 +27,21 @@ function validateGuildId(value) {
         return 'Invalid format (should be 17-20 digits)';
     return undefined;
 }
+function generateInviteUrl(clientId) {
+    const url = new URL('https://discord.com/api/oauth2/authorize');
+    url.searchParams.set('client_id', clientId);
+    url.searchParams.set('permissions', BOT_PERMISSIONS);
+    url.searchParams.set('scope', BOT_SCOPES);
+    return url.toString();
+}
+async function openUrl(url) {
+    try {
+        await open(url);
+    }
+    catch {
+        // Silently fail - URL is displayed to user anyway
+    }
+}
 export async function runSetupWizard() {
     console.clear();
     p.intro(pc.bgCyan(pc.black(' remote-opencode setup ')));
@@ -38,10 +56,21 @@ export async function runSetupWizard() {
             return;
         }
     }
-    p.note(`1. Go to ${pc.cyan(DISCORD_DEV_URL)}\n` +
-        `2. Click ${pc.bold('"New Application"')}\n` +
-        `3. Give your application a name\n` +
-        `4. Copy the ${pc.bold('Application ID')} from "General Information"`, 'Step 1: Create Discord Application');
+    // Step 1: Open Discord Developer Portal
+    p.note(`We'll open the Discord Developer Portal in your browser.\n\n` +
+        `1. Click ${pc.bold('"New Application"')}\n` +
+        `2. Give your application a name (e.g., "Remote OpenCode")\n` +
+        `3. Copy the ${pc.bold('Application ID')} from "General Information"`, 'Step 1: Create Discord Application');
+    const openPortal = await p.text({
+        message: `Press ${pc.cyan('Enter')} to open Discord Developer Portal...`,
+        placeholder: 'Press Enter',
+        defaultValue: '',
+    });
+    if (p.isCancel(openPortal)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+    }
+    await openUrl(DISCORD_DEV_URL);
     const clientId = await p.text({
         message: 'Enter your Discord Application ID:',
         placeholder: 'e.g., 1234567890123456789',
@@ -51,19 +80,27 @@ export async function runSetupWizard() {
         p.cancel('Setup cancelled.');
         process.exit(0);
     }
-    p.note(`1. Go to the ${pc.bold('"Bot"')} section in the left sidebar\n` +
+    // Step 2: Enable Intents (guidance only)
+    p.note(`In the Discord Developer Portal:\n\n` +
+        `1. Go to the ${pc.bold('"Bot"')} section in the left sidebar\n` +
         `2. Scroll down to ${pc.bold('"Privileged Gateway Intents"')}\n` +
         `3. Enable these intents:\n` +
-        `   • ${pc.green('SERVER MEMBERS INTENT')}\n` +
-        `   • ${pc.green('MESSAGE CONTENT INTENT')}\n` +
-        `4. Click "Save Changes"`, 'Step 2: Enable Required Intents');
-    await p.confirm({
+        `   ${pc.green('*')} SERVER MEMBERS INTENT\n` +
+        `   ${pc.green('*')} MESSAGE CONTENT INTENT\n` +
+        `4. Click ${pc.bold('"Save Changes"')}`, 'Step 2: Enable Required Intents');
+    const intentsConfirm = await p.confirm({
         message: 'Have you enabled the required intents?',
         initialValue: true,
     });
-    p.note(`1. In the ${pc.bold('"Bot"')} section\n` +
+    if (p.isCancel(intentsConfirm)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+    }
+    // Step 3: Get Bot Token (guidance only)
+    p.note(`Still in the Discord Developer Portal:\n\n` +
+        `1. In the ${pc.bold('"Bot"')} section\n` +
         `2. Click ${pc.bold('"Reset Token"')} (or "View Token" if available)\n` +
-        `3. Copy the token (it's only shown once!)`, 'Step 3: Get Bot Token');
+        `3. Copy the token ${pc.dim('(it\'s only shown once!)')}`, 'Step 3: Get Bot Token');
     const discordToken = await p.password({
         message: 'Enter your Discord Bot Token:',
         validate: validateToken,
@@ -72,7 +109,8 @@ export async function runSetupWizard() {
         p.cancel('Setup cancelled.');
         process.exit(0);
     }
-    p.note(`1. Open Discord and go to User Settings > Advanced\n` +
+    // Step 4: Get Guild ID (guidance only)
+    p.note(`1. Open Discord and go to ${pc.bold('User Settings > Advanced')}\n` +
         `2. Enable ${pc.bold('"Developer Mode"')}\n` +
         `3. Right-click on your server name\n` +
         `4. Click ${pc.bold('"Copy Server ID"')}`, 'Step 4: Get Guild (Server) ID');
@@ -85,6 +123,7 @@ export async function runSetupWizard() {
         p.cancel('Setup cancelled.');
         process.exit(0);
     }
+    // Save configuration
     const s = p.spinner();
     s.start('Saving configuration...');
     setBotConfig({
@@ -93,9 +132,22 @@ export async function runSetupWizard() {
         guildId: guildId,
     });
     s.stop('Configuration saved!');
-    const inviteUrl = `https://discord.com/api/oauth2/authorize?client_id=${clientId}&permissions=2147534848&scope=bot`;
-    p.note(`Open this URL in your browser:\n\n${pc.cyan(inviteUrl)}\n\n` +
-        `Select your server and authorize the bot.`, 'Step 5: Invite Bot to Server');
+    // Step 5: Invite Bot to Server
+    const inviteUrl = generateInviteUrl(clientId);
+    p.note(`We'll open the bot invite page in your browser.\n\n` +
+        `1. Select your server\n` +
+        `2. Click ${pc.bold('"Authorize"')}\n\n` +
+        `${pc.dim('URL: ' + inviteUrl)}`, 'Step 5: Invite Bot to Server');
+    const openInvite = await p.text({
+        message: `Press ${pc.cyan('Enter')} to open the invite page...`,
+        placeholder: 'Press Enter',
+        defaultValue: '',
+    });
+    if (p.isCancel(openInvite)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+    }
+    await openUrl(inviteUrl);
     const invited = await p.confirm({
         message: 'Have you invited the bot to your server?',
         initialValue: true,
@@ -104,6 +156,7 @@ export async function runSetupWizard() {
         p.cancel('Setup cancelled.');
         process.exit(0);
     }
+    // Step 6: Deploy Commands
     const shouldDeploy = await p.confirm({
         message: 'Deploy slash commands now?',
         initialValue: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-opencode",
-  "version": "1.0.4",
+  "version": "1.0.7",
   "description": "Discord bot for remote OpenCode CLI access",
   "main": "dist/src/index.js",
   "bin": {
@@ -41,10 +41,13 @@
     "discord.js": "^14.25.1",
     "eventsource": "^4.1.0",
     "node-pty": "^1.1.0",
-    "picocolors": "^1.1.1"
+    "open": "^10.1.0",
+    "picocolors": "^1.1.1",
+    "update-notifier": "^7.3.1"
   },
   "devDependencies": {
     "@types/node": "^25.1.0",
+    "@types/update-notifier": "^6.0.8",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"