gsd-pi 0.1.2 → 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>
 
@@ -118,27 +115,31 @@ The wizard is the on-ramp. Auto mode is the highway.
 
 ## Getting Started
 
-### Install and run
+### Install
 
 ```bash
 npm install -g gsd-pi
-cd your-project
-gsd
 ```
 
-That's it. GSD walks you through describing what you want to build, creates a roadmap, and starts working. When you're ready to let it run autonomously:
+### Use it
 
+Open a terminal in your project and run:
+
+```bash
+gsd
 ```
-/gsd auto
-```
 
-Walk away. Come back to a built project with clean git history.
+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 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 two-terminal workflow
+### Two terminals, one project
 
-GSD is designed for you to keep working while it builds. Open two terminals in the same project:
+The real workflow: run auto mode in one terminal, steer from another.
 
-**Terminal 1 — auto mode (let it run)**
+**Terminal 1 — let it build**
 ```bash
 gsd
 /gsd auto
@@ -152,17 +153,17 @@ gsd
 /gsd queue      # queue the next milestone
 ```
 
-Auto mode reads state from `.gsd/` files on disk. Your discussions and decisions in terminal 2 are picked up automatically at the next phase boundary. You don't need to stop auto mode to influence what it does next.
+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. Keys are stored in `~/.gsd/agent/auth.json`.
+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` | 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 discuss` | Discuss architecture and decisions (works alongside auto mode) |

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.2",
+  "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");