gsd-pi 2.3.5 → 2.3.7

package/README.md

@@ -2,11 +2,11 @@
 
 # GSD 2
 
-**The evolution of [Get Shit Done](https://github.com/glittercowboy/get-shit-done) — now a real coding agent.**
+**The evolution of [Get Shit Done](https://github.com/gsd-build/get-shit-done) — now a real coding agent.**
 
 [![npm version](https://img.shields.io/npm/v/gsd-pi?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/gsd-pi)
 [![npm downloads](https://img.shields.io/npm/dm/gsd-pi?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/gsd-pi)
-[![GitHub stars](https://img.shields.io/github/stars/glittercowboy/gsd-pi?style=for-the-badge&logo=github&color=181717)](https://github.com/glittercowboy/gsd-pi)
+[![GitHub stars](https://img.shields.io/github/stars/gsd-build/GSD-2?style=for-the-badge&logo=github&color=181717)](https://github.com/gsd-build/GSD-2)
 [![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
 
 The original GSD went viral as a prompt framework for Claude Code. It worked, but it was fighting the tool — injecting prompts through slash commands, hoping the LLM would follow instructions, with no actual control over context windows, sessions, or execution.
@@ -122,16 +122,18 @@ Auto mode is a state machine driven by files on disk. It reads `.gsd/STATE.md`,
 
 9. **Escape hatch** — Press Escape to pause. The conversation is preserved. Interact with the agent, inspect what happened, or just `/gsd auto` to resume from disk state.
 
-### The `/gsd` Wizard
+### `/gsd` and `/gsd next` — Step Mode
 
-When you're not in auto mode, `/gsd` reads disk state and shows contextual options:
+By default, `/gsd` runs in **step mode**: the same state machine as auto mode, but it pauses between units with a wizard showing what completed and what's next. You advance one step at a time, review the output, and continue when ready.
 
 - **No `.gsd/` directory** → Start a new project. Discussion flow captures your vision, constraints, and preferences.
 - **Milestone exists, no roadmap** → Discuss or research the milestone.
-- **Roadmap exists, slices pending** → Plan the next slice, or jump straight to auto.
+- **Roadmap exists, slices pending** → Plan the next slice, execute one task, or switch to auto.
 - **Mid-task** → Resume from where you left off.
 
-The wizard is the on-ramp. Auto mode is the highway.
+`/gsd next` is an explicit alias for step mode. You can switch from step → auto mid-session via the wizard.
+
+Step mode is the on-ramp. Auto mode is the highway.
 
 ---
 
@@ -170,7 +172,7 @@ gsd
 
 GSD opens an interactive agent session. From there, you have two ways to work:
 
-**`/gsd` — guided mode.** Type `/gsd` and GSD reads your project state and walks you through whatever's next. No project yet? It helps you describe what you want to build. Roadmap exists? It plans the next slice. Mid-task? It resumes. This is the hands-on mode where you work *with* the agent step by step.
+**`/gsd` — step mode.** Type `/gsd` and GSD executes one unit of work at a time, pausing between each with a wizard showing what completed and what's next. Same state machine as auto mode, but you stay in the loop. No project yet? It starts the discussion flow. Roadmap exists? It plans or executes the next step.
 
 **`/gsd auto` — autonomous mode.** Type `/gsd auto` and walk away. GSD researches, plans, executes, verifies, commits, and advances through every slice until the milestone is complete. Fresh context window per task. No babysitting.
 
@@ -196,13 +198,14 @@ Both terminals read and write the same `.gsd/` files on disk. Your decisions in
 
 ### First launch
 
-On first run, GSD prompts for optional API keys (Brave Search, Context7, Jina) for web research and documentation tools. All optional — press Enter to skip any.
+On first run, GSD prompts for optional API keys (Brave Search, Google Gemini, Context7, Jina) for web research and documentation tools. All optional — press Enter to skip any.
 
 ### Commands
 
 | Command | What it does |
 |---------|-------------|
-| `/gsd` | Guided mode — reads project state, walks you through what's next |
+| `/gsd` | Step mode — executes one unit at a time, pauses between each |
+| `/gsd next` | Explicit step mode (same as bare `/gsd`) |
 | `/gsd auto` | Autonomous mode — researches, plans, executes, commits, repeats |
 | `/gsd stop` | Stop auto mode gracefully |
 | `/gsd discuss` | Discuss architecture and decisions (works alongside auto mode) |
@@ -211,7 +214,13 @@ On first run, GSD prompts for optional API keys (Brave Search, Context7, Jina) f
 | `/gsd prefs` | Model selection, timeouts, budget ceiling |
 | `/gsd migrate` | Migrate a v1 `.planning` directory to `.gsd` format |
 | `/gsd doctor` | Validate `.gsd/` integrity, find and fix issues |
+| `/worktree` (`/wt`) | Git worktree lifecycle — create, switch, merge, remove |
+| `/voice` | Toggle real-time speech-to-text (macOS only) |
+| `/exit` | Kill GSD process immediately |
+| `/clear` | Start a new session (alias for `/new`) |
 | `Ctrl+Alt+G` | Toggle dashboard overlay |
+| `Ctrl+Alt+V` | Toggle voice transcription |
+| `Ctrl+Alt+B` | Show background shell processes |
 
 ---
 
@@ -311,16 +320,20 @@ budget_ceiling: 50.00
 
 ### Bundled Tools
 
-GSD ships with 9 extensions, all loaded automatically:
+GSD ships with 13 extensions, all loaded automatically:
 
 | Extension | What it provides |
 |-----------|-----------------|
 | **GSD** | Core workflow engine, auto mode, commands, dashboard |
 | **Browser Tools** | Playwright-based browser for UI verification |
 | **Search the Web** | Brave Search + Jina page extraction |
+| **Google Search** | Gemini-powered web search with AI-synthesized answers |
 | **Context7** | Up-to-date library/framework documentation |
 | **Background Shell** | Long-running process management with readiness detection |
 | **Subagent** | Delegated tasks with isolated context windows |
+| **Mac Tools** | macOS native app automation via Accessibility APIs |
+| **MCPorter** | Lazy on-demand MCP server integration |
+| **Voice** | Real-time speech-to-text transcription (macOS) |
 | **Slash Commands** | Custom command creation |
 | **Ask User Questions** | Structured user input with single/multi-select |
 | **Secure Env Collect** | Masked secret collection without manual .env editing |
@@ -345,12 +358,12 @@ GSD is a TypeScript application that embeds the Pi coding agent SDK.
 gsd (CLI binary)
   └─ loader.ts          Sets PI_PACKAGE_DIR, GSD env vars, dynamic-imports cli.ts
       └─ cli.ts         Wires SDK managers, loads extensions, starts InteractiveMode
-          ├─ wizard.ts       First-run API key collection (Brave/Context7/Jina)
+          ├─ wizard.ts       First-run API key collection (Brave/Gemini/Context7/Jina)
           ├─ app-paths.ts    ~/.gsd/agent/, ~/.gsd/sessions/, auth.json
           ├─ resource-loader.ts  Syncs bundled extensions + agents to ~/.gsd/agent/
           └─ src/resources/
               ├─ extensions/gsd/    Core GSD extension (auto, state, commands, ...)
-              ├─ extensions/...     10 supporting extensions
+              ├─ extensions/...     12 supporting extensions
               ├─ agents/            scout, researcher, worker
               ├─ AGENTS.md          Agent routing instructions
               └─ GSD-WORKFLOW.md    Manual bootstrap protocol
@@ -373,6 +386,7 @@ gsd (CLI binary)
 
 Optional:
 - Brave Search API key (web research)
+- Google Gemini API key (web research via Gemini Search grounding)
 - Context7 API key (library docs)
 - Jina API key (page extraction)
 

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { AuthStorage, DefaultResourceLoader, ModelRegistry, SettingsManager, SessionManager, createAgentSession, InteractiveMode, runPrintMode, } from '@mariozechner/pi-coding-agent';
-import { readFileSync } from 'node:fs';
+import { existsSync, readdirSync, renameSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { agentDir, sessionsDir, authFilePath } from './app-paths.js';
 import { initResources } from './resource-loader.js';
@@ -144,6 +144,29 @@ if (isPrintMode) {
 const cwd = process.cwd();
 const safePath = `--${cwd.replace(/^[/\\]/, '').replace(/[/\\:]/g, '-')}--`;
 const projectSessionsDir = join(sessionsDir, safePath);
+// Migrate legacy flat sessions: before per-directory scoping, all .jsonl session
+// files lived directly in ~/.gsd/sessions/. Move them into the correct per-cwd
+// subdirectory so /resume can find them.
+if (existsSync(sessionsDir)) {
+    try {
+        const entries = readdirSync(sessionsDir);
+        const flatJsonl = entries.filter(f => f.endsWith('.jsonl'));
+        if (flatJsonl.length > 0) {
+            const { mkdirSync } = await import('node:fs');
+            mkdirSync(projectSessionsDir, { recursive: true });
+            for (const file of flatJsonl) {
+                const src = join(sessionsDir, file);
+                const dst = join(projectSessionsDir, file);
+                if (!existsSync(dst)) {
+                    renameSync(src, dst);
+                }
+            }
+        }
+    }
+    catch {
+        // Non-fatal — don't block startup if migration fails
+    }
+}
 const sessionManager = SessionManager.create(cwd, projectSessionsDir);
 initResources(agentDir);
 const resourceLoader = new DefaultResourceLoader({ agentDir });

package/dist/wizard.js

@@ -81,6 +81,8 @@ export function loadStoredEnvKeys(authStorage) {
         ['brave_answers', 'BRAVE_ANSWERS_KEY'],
         ['context7', 'CONTEXT7_API_KEY'],
         ['jina', 'JINA_API_KEY'],
+        ['slack_bot', 'SLACK_BOT_TOKEN'],
+        ['discord_bot', 'DISCORD_BOT_TOKEN'],
     ];
     for (const [provider, envVar] of providers) {
         if (!process.env[envVar]) {
@@ -120,6 +122,20 @@ const API_KEYS = [
         hint: '(clean page extraction)',
         description: 'High-quality web page content extraction',
     },
+    {
+        provider: 'slack_bot',
+        envVar: 'SLACK_BOT_TOKEN',
+        label: 'Slack Bot',
+        hint: '(remote questions in auto-mode)',
+        description: 'Bot token for remote questions via Slack',
+    },
+    {
+        provider: 'discord_bot',
+        envVar: 'DISCORD_BOT_TOKEN',
+        label: 'Discord Bot',
+        hint: '(remote questions in auto-mode)',
+        description: 'Bot token for remote questions via Discord',
+    },
 ];
 /**
  * Check for missing optional tool API keys and prompt for them if on a TTY.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-pi",
-  "version": "2.3.5",
+  "version": "2.3.7",
   "description": "GSD — Get Shit Done coding agent",
   "license": "MIT",
   "repository": {

package/patches/@mariozechner+pi-coding-agent+0.57.1.patch

@@ -1,3 +1,63 @@
+diff --git a/node_modules/@mariozechner/pi-coding-agent/dist/core/agent-session.js b/node_modules/@mariozechner/pi-coding-agent/dist/core/agent-session.js
+index 90622c2..cff094b 100644
+--- a/node_modules/@mariozechner/pi-coding-agent/dist/core/agent-session.js
++++ b/node_modules/@mariozechner/pi-coding-agent/dist/core/agent-session.js
+@@ -1007,7 +1007,7 @@ export class AgentSession {
+      * Validates API key, saves to session and settings.
+      * @throws Error if no API key available for the model
+      */
+-    async setModel(model) {
++    async setModel(model, options) {
+         const apiKey = await this._modelRegistry.getApiKey(model);
+         if (!apiKey) {
+             throw new Error(`No API key for ${model.provider}/${model.id}`);
+@@ -1016,7 +1016,9 @@ export class AgentSession {
+         const thinkingLevel = this._getThinkingLevelForModelSwitch();
+         this.agent.setModel(model);
+         this.sessionManager.appendModelChange(model.provider, model.id);
+-        this.settingsManager.setDefaultModelAndProvider(model.provider, model.id);
++        if (options?.persist !== false) {
++            this.settingsManager.setDefaultModelAndProvider(model.provider, model.id);
++        }
+         // Re-clamp thinking level for new model's capabilities
+         this.setThinkingLevel(thinkingLevel);
+         await this._emitModelSelect(model, previousModel, "set");
+@@ -1067,7 +1069,9 @@ export class AgentSession {
+         // Apply model
+         this.agent.setModel(next.model);
+         this.sessionManager.appendModelChange(next.model.provider, next.model.id);
+-        this.settingsManager.setDefaultModelAndProvider(next.model.provider, next.model.id);
++        if (options?.persist !== false) {
++            this.settingsManager.setDefaultModelAndProvider(next.model.provider, next.model.id);
++        }
+         // Apply thinking level.
+         // - Explicit scoped model thinking level overrides current session level
+         // - Undefined scoped model thinking level inherits the current session preference
+@@ -1094,7 +1098,9 @@ export class AgentSession {
+         const thinkingLevel = this._getThinkingLevelForModelSwitch();
+         this.agent.setModel(nextModel);
+         this.sessionManager.appendModelChange(nextModel.provider, nextModel.id);
+-        this.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);
++        if (options?.persist !== false) {
++            this.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);
++        }
+         // Re-clamp thinking level for new model's capabilities
+         this.setThinkingLevel(thinkingLevel);
+         await this._emitModelSelect(nextModel, currentModel, "cycle");
+@@ -1659,11 +1665,11 @@ export class AgentSession {
+             setActiveTools: (toolNames) => this.setActiveToolsByName(toolNames),
+             refreshTools: () => this._refreshToolRegistry(),
+             getCommands,
+-            setModel: async (model) => {
++            setModel: async (model, options) => {
+                 const key = await this.modelRegistry.getApiKey(model);
+                 if (!key)
+                     return false;
+-                await this.setModel(model);
++                await this.setModel(model, options);
+                 return true;
+             },
+             getThinkingLevel: () => this.thinkingLevel,
 diff --git a/node_modules/@mariozechner/pi-coding-agent/dist/core/tools/bash.js b/node_modules/@mariozechner/pi-coding-agent/dist/core/tools/bash.js
 index 27fe820..68f277f 100644
 --- a/node_modules/@mariozechner/pi-coding-agent/dist/core/tools/bash.js

package/scripts/postinstall.js

@@ -44,10 +44,12 @@ try {
 }
 
 // Install Playwright chromium for browser tools (non-fatal)
-const args = os.platform() === 'linux' ? '--with-deps' : ''
 try {
-  execSync(`npx playwright install chromium ${args}`, { stdio: 'inherit' })
+  execSync('npx playwright install chromium', { stdio: 'inherit' })
   process.stderr.write(`\n  ${green}✓${reset} Browser tools ready\n\n`)
 } catch {
-  process.stderr.write(`\n  ${yellow}⚠${reset}  Browser tools unavailable — run ${cyan}npx playwright install chromium${reset} to enable\n\n`)
+  const hint = os.platform() === 'linux'
+    ? `${cyan}npx playwright install --with-deps chromium${reset}`
+    : `${cyan}npx playwright install chromium${reset}`
+  process.stderr.write(`\n  ${yellow}⚠${reset}  Browser tools unavailable — run ${hint} to enable\n\n`)
 }

package/src/resources/extensions/ask-user-questions.ts

@@ -21,12 +21,27 @@ import {
 
 // ─── Types ────────────────────────────────────────────────────────────────────
 
-interface AskUserQuestionsDetails {
+interface LocalResultDetails {
+	remote?: false;
 	questions: Question[];
 	response: RoundResult | null;
 	cancelled: boolean;
 }
 
+interface RemoteResultDetails {
+	remote: true;
+	channel: string;
+	timed_out: boolean;
+	promptId?: string;
+	threadUrl?: string;
+	status?: string;
+	questions?: Question[];
+	response?: import("./remote-questions/types.js").RemoteAnswer;
+	error?: boolean;
+}
+
+type AskUserQuestionsDetails = LocalResultDetails | RemoteResultDetails;
+
 // ─── Schema ───────────────────────────────────────────────────────────────────
 
 const OptionSchema = Type.Object({
@@ -104,7 +119,7 @@ export default function AskUserQuestions(pi: ExtensionAPI) {
 		],
 		parameters: AskUserQuestionsParams,
 
-		async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+		async execute(_toolCallId, params, signal, _onUpdate, ctx) {
 			// Validation
 			if (params.questions.length === 0 || params.questions.length > 3) {
 				return errorResult("Error: questions must contain 1-3 items", params.questions);
@@ -120,6 +135,9 @@ export default function AskUserQuestions(pi: ExtensionAPI) {
 			}
 
 			if (!ctx.hasUI) {
+				const { tryRemoteQuestions } = await import("./remote-questions/manager.js");
+				const remoteResult = await tryRemoteQuestions(params.questions, signal);
+				if (remoteResult) return remoteResult;
 				return errorResult("Error: UI not available (non-interactive mode)", params.questions);
 			}
 
@@ -131,13 +149,13 @@ export default function AskUserQuestions(pi: ExtensionAPI) {
 			if (!hasAnswers) {
 				return {
 					content: [{ type: "text", text: "ask_user_questions was cancelled before receiving a response" }],
-					details: { questions: params.questions, response: null, cancelled: true } as AskUserQuestionsDetails,
+					details: { questions: params.questions, response: null, cancelled: true } satisfies LocalResultDetails,
 				};
 			}
 
 			return {
 				content: [{ type: "text", text: formatForLLM(result) }],
-				details: { questions: params.questions, response: result, cancelled: false } as AskUserQuestionsDetails,
+				details: { questions: params.questions, response: result, cancelled: false } satisfies LocalResultDetails,
 			};
 		},
 
@@ -171,13 +189,44 @@ export default function AskUserQuestions(pi: ExtensionAPI) {
 				return new Text(text?.type === "text" ? text.text : "", 0, 0);
 			}
 
+			// Remote channel result (discriminated on details.remote === true)
+			if (details.remote) {
+				if (details.timed_out) {
+					return new Text(
+						`${theme.fg("warning", `${details.channel} — timed out`)}${details.threadUrl ? theme.fg("dim", ` ${details.threadUrl}`) : ""}`,
+						0,
+						0,
+					);
+				}
+
+				const questions = (details.questions ?? []) as Question[];
+				const lines: string[] = [];
+				lines.push(theme.fg("dim", details.channel));
+				if (details.response) {
+					for (const q of questions) {
+						const answer = details.response.answers[q.id];
+						if (!answer) {
+							lines.push(`${theme.fg("accent", q.header)}: ${theme.fg("dim", "(no answer)")}`);
+							continue;
+						}
+						const answerText = answer.answers.length > 0 ? answer.answers.join(", ") : "(custom)";
+						let line = `${theme.fg("success", "✓ ")}${theme.fg("accent", q.header)}: ${answerText}`;
+						if (answer.user_note) {
+							line += ` ${theme.fg("muted", `[note: ${answer.user_note}]`)}`;
+						}
+						lines.push(line);
+					}
+				}
+				return new Text(lines.join("\n"), 0, 0);
+			}
+
 			if (details.cancelled || !details.response) {
 				return new Text(theme.fg("warning", "Cancelled"), 0, 0);
 			}
 
 			const lines: string[] = [];
 			for (const q of details.questions) {
-				const answer = details.response.answers[q.id];
+				const answer = (details.response as RoundResult).answers[q.id];
 				if (!answer) {
 					lines.push(`${theme.fg("accent", q.header)}: ${theme.fg("dim", "(no answer)")}`);
 					continue;

package/src/resources/extensions/gsd/auto.ts

@@ -247,6 +247,14 @@ export async function startAuto(
     if (!getLedger()) initMetrics(base);
     ctx.ui.setStatus("gsd-auto", stepMode ? "next" : "auto");
     ctx.ui.notify(stepMode ? "Step-mode resumed." : "Auto-mode resumed.", "info");
+    // Rebuild disk state before resuming — user interaction during pause may have changed files
+    try { await rebuildState(base); } catch { /* non-fatal */ }
+    try {
+      const report = await runGSDDoctor(base, { fix: true });
+      if (report.fixesApplied.length > 0) {
+        ctx.ui.notify(`Resume: applied ${report.fixesApplied.length} fix(es) to state.`, "info");
+      }
+    } catch { /* non-fatal */ }
     await dispatchNextUnit(ctx, pi);
     return;
   }
@@ -758,7 +766,12 @@ async function dispatchNextUnit(
   ctx: ExtensionContext,
   pi: ExtensionAPI,
 ): Promise<void> {
-  if (!active || !cmdCtx) return;
+  if (!active || !cmdCtx) {
+    if (active && !cmdCtx) {
+      ctx.ui.notify("Auto-mode dispatch failed: no command context. Run /gsd auto to restart.", "error");
+    }
+    return;
+  }
 
   let state = await deriveState(basePath);
   let mid = state.activeMilestone?.id;
@@ -1086,7 +1099,7 @@ async function dispatchNextUnit(
     const allModels = ctx.modelRegistry.getAll();
     const model = allModels.find(m => m.id === preferredModelId);
     if (model) {
-      const ok = await pi.setModel(model);
+      const ok = await pi.setModel(model, { persist: false });
       if (ok) {
         ctx.ui.notify(`Model: ${preferredModelId}`, "info");
       }
@@ -1186,7 +1199,8 @@ async function dispatchNextUnit(
     await pauseAuto(ctx, pi);
   }, hardTimeoutMs);
 
-  // Inject prompt
+  // Inject prompt — verify auto-mode still active (guards against race with timeout/pause)
+  if (!active) return;
   pi.sendMessage(
     { customType: "gsd-auto", content: finalPrompt, display: verbose },
     { triggerTurn: true },

package/src/resources/extensions/gsd/commands.ts

@@ -31,6 +31,7 @@ import {
 } from "./doctor.js";
 import { loadPrompt } from "./prompt-loader.js";
 import { handleMigrate } from "./migrate/command.js";
+import { handleRemote } from "../remote-questions/remote-command.js";
 
 function dispatchDoctorHeal(pi: ExtensionAPI, scope: string | undefined, reportText: string, structuredIssues: string): void {
   const workflowPath = process.env.GSD_WORKFLOW_PATH ?? join(process.env.HOME ?? "~", ".pi", "GSD-WORKFLOW.md");
@@ -52,10 +53,10 @@ function dispatchDoctorHeal(pi: ExtensionAPI, scope: string | undefined, reportT
 
 export function registerGSDCommand(pi: ExtensionAPI): void {
   pi.registerCommand("gsd", {
-    description: "GSD — Get Shit Done: /gsd next|auto|stop|status|queue|prefs|doctor|migrate",
+    description: "GSD — Get Shit Done: /gsd next|auto|stop|status|queue|prefs|doctor|migrate|remote",
 
     getArgumentCompletions: (prefix: string) => {
-      const subcommands = ["next", "auto", "stop", "status", "queue", "discuss", "prefs", "doctor", "migrate"];
+      const subcommands = ["next", "auto", "stop", "status", "queue", "discuss", "prefs", "doctor", "migrate", "remote"];
       const parts = prefix.trim().split(/\s+/);
 
       if (parts.length <= 1) {
@@ -78,6 +79,13 @@ export function registerGSDCommand(pi: ExtensionAPI): void {
           .map((cmd) => ({ value: `prefs ${cmd}`, label: cmd }));
       }
 
+      if (parts[0] === "remote" && parts.length <= 2) {
+        const subPrefix = parts[1] ?? "";
+        return ["slack", "discord", "status", "disconnect"]
+          .filter((cmd) => cmd.startsWith(subPrefix))
+          .map((cmd) => ({ value: `remote ${cmd}`, label: cmd }));
+      }
+
       if (parts[0] === "doctor") {
         const modePrefix = parts[1] ?? "";
         const modes = ["fix", "heal", "audit"];
@@ -148,6 +156,11 @@ export function registerGSDCommand(pi: ExtensionAPI): void {
         return;
       }
 
+      if (trimmed === "remote" || trimmed.startsWith("remote ")) {
+        await handleRemote(trimmed.replace(/^remote\s*/, "").trim(), ctx, pi);
+        return;
+      }
+
       if (trimmed === "") {
         // Bare /gsd defaults to step mode
         await startAuto(ctx, pi, process.cwd(), false, { step: true });
@@ -155,7 +168,7 @@ export function registerGSDCommand(pi: ExtensionAPI): void {
       }
 
       ctx.ui.notify(
-        `Unknown: /gsd ${trimmed}. Use /gsd, /gsd next, /gsd auto, /gsd stop, /gsd status, /gsd queue, /gsd discuss, /gsd prefs [global|project|status], /gsd doctor [audit|fix|heal] [M###/S##], or /gsd migrate <path>.`,
+        `Unknown: /gsd ${trimmed}. Use /gsd, /gsd next, /gsd auto, /gsd stop, /gsd status, /gsd queue, /gsd discuss, /gsd prefs [global|project|status], /gsd doctor [audit|fix|heal] [M###/S##], /gsd migrate <path>, or /gsd remote [slack|discord|status|disconnect].`,
         "warning",
       );
     },

package/src/resources/extensions/gsd/index.ts

@@ -102,7 +102,7 @@ export default function (pi: ExtensionAPI) {
   };
   pi.registerTool(dynamicBash as any);
 
-  // ── session_start: render branded GSD header ───────────────────────────
+  // ── session_start: render branded GSD header + remote channel status ──
   pi.on("session_start", async (_event, ctx) => {
     const theme = ctx.ui.theme;
     const version = process.env.GSD_VERSION || "0.0.0";
@@ -112,6 +112,22 @@ export default function (pi: ExtensionAPI) {
 
     const headerContent = `${logoText}\n${titleLine}`;
     ctx.ui.setHeader((_ui, _theme) => new Text(headerContent, 1, 0));
+
+    // Notify remote questions status if configured
+    try {
+      const [{ getRemoteConfigStatus }, { getLatestPromptSummary }] = await Promise.all([
+        import("../remote-questions/config.js"),
+        import("../remote-questions/status.js"),
+      ]);
+      const status = getRemoteConfigStatus();
+      const latest = getLatestPromptSummary();
+      if (!status.includes("not configured")) {
+        const suffix = latest ? `\nLast remote prompt: ${latest.id} (${latest.status})` : "";
+        ctx.ui.notify(`${status}${suffix}`, status.includes("disabled") ? "warning" : "info");
+      }
+    } catch {
+      // Remote questions module not available — ignore
+    }
   });
 
   // ── Ctrl+Alt+G shortcut — GSD dashboard overlay ────────────────────────

package/src/resources/extensions/gsd/preferences.ts

@@ -31,6 +31,13 @@ export interface AutoSupervisorConfig {
   hard_timeout_minutes?: number;
 }
 
+export interface RemoteQuestionsConfig {
+  channel: "slack" | "discord";
+  channel_id: string | number;
+  timeout_minutes?: number;        // clamped to 1-30
+  poll_interval_seconds?: number;  // clamped to 2-30
+}
+
 export interface GSDPreferences {
   version?: number;
   always_use_skills?: string[];
@@ -43,6 +50,7 @@ export interface GSDPreferences {
   auto_supervisor?: AutoSupervisorConfig;
   uat_dispatch?: boolean;
   budget_ceiling?: number;
+  remote_questions?: RemoteQuestionsConfig;
 }
 
 export interface LoadedGSDPreferences {
@@ -430,7 +438,12 @@ function parseFrontmatterBlock(frontmatter: string): GSDPreferences {
 function parseScalar(value: string): string | number | boolean {
   if (value === "true") return true;
   if (value === "false") return false;
-  if (/^-?\d+$/.test(value)) return Number(value);
+  if (/^-?\d+$/.test(value)) {
+    const n = Number(value);
+    // Keep large integers (e.g. Discord channel IDs) as strings to avoid precision loss
+    if (Number.isSafeInteger(n)) return n;
+    return value;
+  }
   return value.replace(/^['\"]|['\"]$/g, "");
 }
 
@@ -495,6 +508,9 @@ function mergePreferences(base: GSDPreferences, override: GSDPreferences): GSDPr
     auto_supervisor: { ...(base.auto_supervisor ?? {}), ...(override.auto_supervisor ?? {}) },
     uat_dispatch: override.uat_dispatch ?? base.uat_dispatch,
     budget_ceiling: override.budget_ceiling ?? base.budget_ceiling,
+    remote_questions: override.remote_questions
+      ? { ...(base.remote_questions ?? {}), ...override.remote_questions }
+      : base.remote_questions,
   };
 }