gsd-pi 0.1.1 → 0.1.3

package/README.md

@@ -15,10 +15,7 @@ This version is different. GSD is now a standalone CLI built on the [Pi SDK](htt
 
 One command. Walk away. Come back to a built project with clean git history.
 
-```bash
-npm install -g gsd-pi
-gsd
-```
+<pre><code>npm install -g gsd-pi</code></pre>
 
 </div>
 
@@ -124,43 +121,55 @@ The wizard is the on-ramp. Auto mode is the highway.
 npm install -g gsd-pi
 ```
 
-Requires Node.js ≥ 20.6.0. Installs Chromium via Playwright for browser-based verification (non-fatal if it fails).
+### Use it
 
-### First Run
+Open a terminal in your project and run:
 
 ```bash
-cd your-project
 gsd
 ```
 
-On first launch, GSD prompts for optional API keys:
-- **Brave Search** — for web research during planning
-- **Context7** — for up-to-date library documentation
-- **Jina** — for web page content extraction
+GSD opens an interactive agent session. From there, you have two ways to work:
 
-All optional. Press Enter to skip any. Keys are stored in `~/.gsd/agent/auth.json` and loaded automatically on subsequent launches.
+**`/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.
 
-### Start Building
+**`/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.
 
-The wizard walks you through describing what you want to build. Once you approve the roadmap:
+### Two terminals, one project
 
-```
+The real workflow: run auto mode in one terminal, steer from another.
+
+**Terminal 1 — let it build**
+```bash
+gsd
 /gsd auto
 ```
 
-Walk away. GSD will research, plan, execute, verify, commit, and advance through every slice until the milestone is complete.
+**Terminal 2 — steer while it works**
+```bash
+gsd
+/gsd discuss    # talk through architecture decisions
+/gsd status     # check progress
+/gsd queue      # queue the next milestone
+```
+
+Both terminals read and write the same `.gsd/` files on disk. Your decisions in terminal 2 are picked up automatically at the next phase boundary — no need to stop auto mode.
+
+### 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.
 
 ### Commands
 
 | Command | What it does |
 |---------|-------------|
-| `/gsd` | Contextual wizard — reads state, shows what's next |
-| `/gsd auto` | Start auto mode (fresh session per unit, loops until done) |
+| `/gsd` | Guided mode — reads project state, walks you through what's next |
+| `/gsd auto` | Autonomous mode — researches, plans, executes, commits, repeats |
 | `/gsd stop` | Stop auto mode gracefully |
-| `/gsd status` | Progress dashboard overlay |
+| `/gsd discuss` | Discuss architecture and decisions (works alongside auto mode) |
+| `/gsd status` | Progress dashboard |
 | `/gsd queue` | Queue future milestones (safe during auto mode) |
-| `/gsd discuss` | Discuss implementation decisions before planning |
-| `/gsd prefs` | Manage skill preferences (global/project) |
+| `/gsd prefs` | Model selection, timeouts, budget ceiling |
 | `/gsd doctor` | Validate `.gsd/` integrity, find and fix issues |
 | `Ctrl+Alt+G` | Toggle dashboard overlay |
 

package/dist/wizard.js

@@ -61,6 +61,7 @@ async function promptMasked(question) {
 export function loadStoredEnvKeys(authStorage) {
     const providers = [
         ['brave', 'BRAVE_API_KEY'],
+        ['brave_answers', 'BRAVE_ANSWERS_KEY'],
         ['context7', 'CONTEXT7_API_KEY'],
         ['jina', 'JINA_API_KEY'],
     ];
@@ -87,13 +88,15 @@ export function loadStoredEnvKeys(authStorage) {
  */
 export async function runWizardIfNeeded(authStorage) {
     const needsBrave = !authStorage.has('brave') && !process.env.BRAVE_API_KEY;
+    const needsBraveAnswers = !authStorage.has('brave_answers') && !process.env.BRAVE_ANSWERS_KEY;
     const needsContext7 = !authStorage.has('context7') && !process.env.CONTEXT7_API_KEY;
     const needsJina = !authStorage.has('jina') && !process.env.JINA_API_KEY;
-    if (!needsBrave && !needsContext7 && !needsJina) {
+    if (!needsBrave && !needsBraveAnswers && !needsContext7 && !needsJina) {
         return;
     }
     const missing = [
         needsBrave && 'Brave Search',
+        needsBraveAnswers && 'Brave Answers',
         needsContext7 && 'Context7',
         needsJina && 'Jina',
     ]
@@ -108,12 +111,19 @@ export async function runWizardIfNeeded(authStorage) {
     process.stdout.write(`\n[gsd] Some optional tool API keys are not configured: ${missing}\n`);
     process.stdout.write('[gsd] Press Enter to skip any key you want to set up later.\n\n');
     if (needsBrave) {
-        const key = await promptMasked('Brave Search API key (optional): ');
+        const key = await promptMasked('Brave Search API key (optional, for web search + LLM context): ');
         if (key) {
             authStorage.set('brave', { type: 'api_key', key });
             process.env.BRAVE_API_KEY = key;
         }
     }
+    if (needsBraveAnswers) {
+        const key = await promptMasked('Brave Answers API key (optional, for AI-generated answers): ');
+        if (key) {
+            authStorage.set('brave_answers', { type: 'api_key', key });
+            process.env.BRAVE_ANSWERS_KEY = key;
+        }
+    }
     if (needsContext7) {
         const key = await promptMasked('Context7 API key (optional): ');
         if (key) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-pi",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "GSD — Get Stuff Done coding agent",
   "license": "BUSL-1.1",
   "repository": {

package/src/resources/extensions/search-the-web/index.ts

@@ -49,16 +49,18 @@ export default function (pi: ExtensionAPI) {
   pi.on("session_start", async (_event, ctx) => {
     const hasBrave = !!process.env.BRAVE_API_KEY;
     const hasJina = !!process.env.JINA_API_KEY;
+    const hasAnswers = !!process.env.BRAVE_ANSWERS_KEY;
 
     if (!hasBrave) {
       ctx.ui.notify(
-        "Web search: Set BRAVE_API_KEY for web search capability",
+        "Web search: Set BRAVE_API_KEY for web search + LLM context capability",
         "warning"
       );
     }
 
     const parts: string[] = ["Web search v3 loaded"];
-    if (hasBrave) parts.push("Brave ✓");
+    if (hasBrave) parts.push("Search ✓");
+    if (hasAnswers) parts.push("Answers ✓");
     if (hasJina) parts.push("Jina ✓");
 
     ctx.ui.notify(parts.join(" · "), "info");