gsd-init 1.0.9 → 1.0.11

package/README.md

@@ -2,22 +2,81 @@
 
 Set up the GSD observer/worker tmux system in your project.
 
-## Usage
+## Install
 
 ```bash
+npm install -g gsd-init
+```
+
+## Commands
+
+### `gsd init <project-name>`
+
+Creates a project folder and installs all GSD files inside it:
+
+```bash
+gsd init my-project
+```
+
+Installs into `my-project/.gsd/` and registers the stop hook in `my-project/.claude/settings.json`.
+
+To run inside an existing project directory:
+
+```bash
+cd my-project
 npx gsd-init
 ```
 
-With auto-confirm:
+### `gsd start`
+
+Starts the observer and worker tmux sessions for the current project. Run from inside the project directory:
+
 ```bash
-npx gsd-init --yes
+cd my-project
+gsd start
 ```
 
-## What it does
+- Creates sessions named `gsd-observer-<project>` and `gsd-worker-<project>`
+- Opens Terminal windows attached to each session
+- Observer session includes a listener daemon that auto-responds to GSD phase events
+
+### `gsd teardown`
 
-1. Installs observer scripts to `~/.claude/gsd-observer/`
-2. Registers a Stop hook in `.claude/settings.json`
-3. Prints next steps for starting the observer and worker sessions
+Kills all GSD tmux sessions for the current project:
+
+```bash
+cd my-project
+gsd teardown
+```
+
+## How it works
+
+```
+my-project/
+├── .gsd/
+│   ├── agents/gsd-observer.md       # Observer Claude agent prompt
+│   ├── hooks/gsd-stop-hook.sh       # Fires after each Claude response in Worker
+│   ├── scripts/
+│   │   ├── start.sh                 # Start observer + worker (used by gsd start)
+│   │   ├── start-observer.sh        # Start observer tmux session
+│   │   ├── start-worker.sh          # Start worker tmux session
+│   │   ├── listen.sh                # Daemon: watches for events, wakes Observer
+│   │   ├── notify-worker.sh         # Injects Observer response into Worker pane
+│   │   ├── wake-observer.sh         # Sends event task to Observer Claude
+│   │   ├── teardown.sh              # Kill all sessions (used by gsd teardown)
+│   │   └── verify.sh                # Verify setup is working
+│   └── schema/
+│       ├── event.json               # Event file schema
+│       └── response.json            # Response file schema
+└── .claude/
+    └── settings.json                # Stop hook registered here
+```
+
+**Observer session** runs two panes:
+- Pane 0: Observer Claude — reviews GSD phase outputs and responds
+- Pane 1: Listener daemon — polls for new events and wakes Claude automatically
+
+**Worker session** runs Claude with `GSD_OBSERVER_ENABLED=1`, which activates the stop hook after each response.
 
 ## Requirements
 
@@ -26,16 +85,3 @@ npx gsd-init --yes
 - jq
 - Claude Code CLI (`claude`)
 - GSD (superpowers plugin) installed in Claude Code
-
-## After install
-
-```bash
-# Start Observer session first
-~/.claude/gsd-observer/scripts/start-observer.sh
-
-# Start Worker session in your project directory
-~/.claude/gsd-observer/scripts/start-worker.sh /path/to/project
-
-# Verify setup
-~/.claude/gsd-observer/scripts/verify.sh
-```

package/bin/gsd.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+'use strict';
+var major = parseInt(process.version.slice(1).split('.')[0], 10);
+if (major < 16) {
+  process.stderr.write('gsd requires Node.js >= 16 (found ' + process.version + ')\n');
+  process.exit(1);
+}
+const { execFileSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const args = process.argv.slice(2);
+const cmd = args[0];
+
+function findScript(name) {
+  var p = path.join(process.cwd(), '.gsd', 'scripts', name);
+  if (!fs.existsSync(p)) {
+    console.error('Error: ' + p + ' not found. Run "gsd init <project-name>" first.');
+    process.exit(1);
+  }
+  return p;
+}
+
+function runScript(name) {
+  var script = findScript(name);
+  execFileSync(script, { stdio: 'inherit' });
+}
+
+switch (cmd) {
+  case 'init': {
+    var projectName = args[1];
+    if (!projectName) {
+      console.error('Usage: gsd init <project-name>');
+      process.exit(1);
+    }
+    var initScript = path.join(__dirname, 'gsd-init.js');
+    execFileSync(process.execPath, [initScript, projectName], { stdio: 'inherit' });
+    break;
+  }
+  case 'start':
+    runScript('start.sh');
+    break;
+  case 'teardown':
+    runScript('teardown.sh');
+    break;
+  default:
+    console.log([
+      'Usage:',
+      '  gsd init <project-name>   Create project folder and install GSD',
+      '  gsd start                 Start observer + worker tmux sessions',
+      '  gsd teardown              Kill all GSD tmux sessions',
+    ].join('\n'));
+    process.exit(cmd ? 1 : 0);
+}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "gsd-init",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Set up GSD observer/worker tmux system in a project",
   "bin": {
-    "gsd-init": "bin/gsd-init.js"
+    "gsd-init": "bin/gsd-init.js",
+    "gsd": "bin/gsd.js"
   },
   "files": [
     "bin",