apigrip 0.2.3 → 0.3.0

package/README.md

@@ -9,8 +9,19 @@ The spec file on disk is the only source of truth. It is never imported, copied,
 ## Quick start
 
 ```bash
-npm install
-npm start -- --project /path/to/your/api
+# Install globally
+npm install -g apigrip
+
+# Bookmark a project and start the UI
+apigrip projects add /path/to/your/api
+apigrip serve
+```
+
+Or run from inside a project directory (auto-detects the spec):
+
+```bash
+cd /path/to/your/api
+apigrip serve
 ```
 
 Open `http://127.0.0.1:3000` in your browser.
@@ -24,7 +35,7 @@ Open `http://127.0.0.1:3000` in your browser.
 
 - Browse endpoints from any OpenAPI 2.0, 3.0.x, or 3.1.x spec
 - Send requests via curl subprocess with full `curl -v` level detail
-- Live reload on spec changes, git branch switches, and `$ref` dependency updates
+- Live reload on spec changes, git branch switches, and `$ref` dependency updates (web UI and MCP)
 - Parameter persistence across restarts (auto-saved per project, per endpoint)
 - Named environments with `{{ variable }}` syntax resolved at send time
 - Git status bar showing branch, commit, and dirty/clean state
@@ -37,8 +48,9 @@ Open `http://127.0.0.1:3000` in your browser.
 
 ```bash
 # Start the web UI
-apigrip serve                                    # default port 3000
+apigrip serve                                    # loads last bookmarked project
 apigrip serve --port 8080 --open                 # custom port, open browser
+apigrip serve --project /path/to/api             # explicit project
 
 # Send requests from the terminal
 apigrip send GET /users                          # basic request
@@ -95,6 +107,8 @@ CLI commands auto-detect the project from the current working directory:
 3. If cwd contains an OpenAPI spec file, use it directly
 4. Otherwise, error
 
+The `serve` command has additional fallbacks: if cwd is a git repo with a spec, it uses that. Otherwise it loads the first bookmarked project. Opening a project in the web UI automatically bookmarks it.
+
 ## Web UI
 
 Two-panel layout: request on the left, response on the right.
@@ -103,7 +117,7 @@ Two-panel layout: request on the left, response on the right.
 
 **Right panel** -- status badge, timing, response body (pretty-printed), headers, verbose `curl -v` output, copyable curl command.
 
-**Keyboard shortcuts**: `Ctrl+P` (command palette), `Ctrl+O` (open project), `Ctrl+E` (environment editor), `Ctrl+Enter` (send request).
+**Keyboard shortcuts**: `Ctrl+P` (command palette), `Ctrl+O` (open project), `Ctrl+E` (environment editor), `Ctrl+Enter` (send request), `Ctrl+Shift+L` (toggle theme).
 
 ## Environments
 
@@ -183,6 +197,8 @@ Expose the spec to AI coding assistants via the Model Context Protocol:
 
 **Resources:** `spec://parsed`, `project://info`
 
+The MCP server watches the spec file and auto-reloads when it changes, so tools always return current data.
+
 ## Project structure
 
 ```
@@ -233,7 +249,7 @@ Config is stored at `$XDG_CONFIG_HOME/apigrip/` (or `~/.config/apigrip/`). Proje
 npm test
 ```
 
-Runs 282 tests across 17 test files using Node's built-in test runner (`node --test`). The test suite uses the tool's own OpenAPI spec as a fixture (self-referential testing).
+Runs 741 tests using Node's built-in test runner (`node --test`). The test suite uses the tool's own OpenAPI spec as a fixture (self-referential testing).
 
 ## License
 

package/cli/commands/mcp.js

@@ -2,6 +2,7 @@ import { parseSpec } from '../../core/spec-parser.js';
 import { createMcpServer } from '../../mcp/server.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { resolveProjectContext } from '../resolve-project.js';
+import chokidar from 'chokidar';
 
 export async function mcpCommand(argv) {
   const { projectDir, specPath } = await resolveProjectContext(argv);
@@ -19,7 +20,28 @@ export async function mcpCommand(argv) {
     process.exit(2);
   }
 
-  const server = await createMcpServer({ projectDir, specPath, spec });
+  const state = { projectDir, specPath, spec };
+  const server = await createMcpServer(state);
+
+  // Watch spec file for changes and auto-reload
+  const watcher = chokidar.watch(specPath, {
+    ignoreInitial: true,
+    awaitWriteFinish: { stabilityThreshold: 50, pollInterval: 10 },
+  });
+
+  let reloadTimer = null;
+  watcher.on('change', () => {
+    if (reloadTimer) clearTimeout(reloadTimer);
+    reloadTimer = setTimeout(async () => {
+      try {
+        state.spec = await parseSpec(specPath);
+        console.error(`[apigrip] Spec reloaded`);
+      } catch (err) {
+        console.error(`[apigrip] Spec reload error: ${err.message}`);
+      }
+    }, 100);
+  });
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/cli/commands/serve.js

@@ -2,6 +2,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { parseSpec } from '../../core/spec-parser.js';
 import { createServer } from '../../server/index.js';
+import { createSpecWatcher } from '../../server/spec-watcher.js';
+import { broadcast } from '../../server/routes/events.js';
 import { findProjectForDir, loadProjects } from '../../core/projects-store.js';
 import { discoverSpec } from '../../core/spec-discovery.js';
 
@@ -81,7 +83,12 @@ export async function serveCommand(argv) {
     console.warn('         Use --no-browse to disable directory listing and project switching.');
   }
 
-  const { app } = createServer({ projectDir, specPath, spec, noBrowse });
+  const { app, state } = createServer({ projectDir, specPath, spec, noBrowse });
+
+  // Start file watcher for live reload
+  if (specPath) {
+    createSpecWatcher(state, broadcast).catch(() => {});
+  }
 
   const server = app.listen(port, host, () => {
     console.log(`Server listening on http://${host}:${port}`);