npm - @contextstream/mcp-server - Versions diffs - 0.4.29 → 0.4.30 - Mend

@contextstream/mcp-server 0.4.29 → 0.4.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/LICENSE CHANGED Viewed

@@ -1,21 +1,21 @@
-MIT License
-Copyright (c) 2025 ContextStream
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+Copyright (c) 2025 ContextStream
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,416 +1,460 @@
-# ContextStream MCP Server
-**Get set up in 30 seconds (recommended):**
-```bash
-npx -y @contextstream/mcp-server setup
-```
-This wizard authenticates you, creates/stores an API key, installs editor rules, and writes MCP config files.
-Persistent memory, semantic search, and code intelligence for any MCP-compatible AI tool (Cursor, Claude Code, Windsurf, VS Code, Claude Desktop, Codex CLI, etc.).
-**At a glance:**
-- Shared "brain" for decisions, preferences, notes (including implementation notes), lessons, tasks, and project context.
-- Search + analysis across sessions with consistent context (semantic/hybrid/keyword + graph tools).
-- v0.4.x consolidated domain tools (~11 tools) for ~75% lower tool-registry token overhead vs previous versions.
----
-## Just Ask
-**You don't need to memorize tool names.** Describe what you want and your AI will call the right ContextStream tools:
-| You say… | ContextStream does… |
-|----------|---------------------|
-| "session summary" | Summarizes current workspace/project context |
-| "what did we decide about auth?" | Recalls decisions related to authentication |
-| "remember we're using PostgreSQL" | Captures that fact for future sessions |
-| "search for payment code" | Searches your codebase semantically/hybrid/keyword |
-| "what depends on UserService?" | Analyzes dependency graph & impact |
-> **Tip:** For best results, add the **recommended editor rules** so your AI reliably calls `session_init` / `context_smart` when appropriate:
-> https://contextstream.io/docs/quickstart
-![ContextStream in action](compare1.gif)
----
-## Choose Your Mode (Token Footprint)
-MCP clients often inject the tool catalog into the model context. v0.4.x is designed to keep that overhead small.
-| Mode | What it exposes | Best for | Enable |
-|------|-----------------|----------|--------|
-| **Consolidated** (default) | ~11 domain tools with `action` / `mode` dispatch | Most users (recommended) | `CONTEXTSTREAM_CONSOLIDATED=true` |
-| **Router** (extreme minimization) | ~2 meta-tools (`contextstream`, `contextstream_help`) | Tight context budgets / many MCP servers | `CONTEXTSTREAM_PROGRESSIVE_MODE=true` |
-| **Legacy** (granular tools) | Older `light/standard/complete` toolsets | Back-compat / old prompts | `CONTEXTSTREAM_CONSOLIDATED=false` |
-> **Note:** The env var name for Router mode is `CONTEXTSTREAM_PROGRESSIVE_MODE` (historical naming). It enables the ~2-tool "router" surface.
----
-## Features
-- **Consolidated domain tools** (v0.4.x): short tool list with action/mode dispatch
-- Session-aware context loading (`session_init`, `context_smart`)
-- Memory capture + recall (decisions, preferences, notes, implementation notes, lessons, tasks, bugs)
-- Code search (semantic, hybrid, keyword, pattern)
-- Knowledge graph + code analysis (dependencies, impact, call paths, circular deps, unused code)
-- Graph ingestion for full graph builds (`graph(action="ingest")`)
-- Local repo ingestion for indexing (`project(action="ingest_local")`)
-- Auto-context: on first tool call in a new session, the server can auto-initialize context
-> **⚠️ Search-First Rule:** For best results, your AI should use ContextStream `search(mode="hybrid")` **before** local tools like Glob/Grep/Read. This is enforced via editor rules and `context_smart` responses.
----
-## Graph Tiers
-| Tier | Capabilities |
-|------|--------------|
-| **Pro (Graph-Lite)** | Module-level import graph, dependencies, and 1-hop impact |
-| **Elite/Team (Full Graph)** | Module + call + dataflow + type layers, plus full graph ingestion |
----
-## Requirements
-- **Node.js 18+**
-- A **ContextStream account**
-- Auth via **API key** or **JWT**
-Default API URL: `https://api.contextstream.io`
----
-## Quickstart (2 minutes)
-### 1) Run the Setup Wizard (recommended)
-The wizard:
-- Authenticates (browser/device login by default)
-- Creates/stores an API key
-- Installs recommended editor rules (optional)
-- Writes MCP config files for supported tools
-```bash
-npx -y @contextstream/mcp-server setup
-```
-**Useful flags:**
-| Flag | Description |
-|------|-------------|
-| `--dry-run` | Preview without writing files |
-**Notes:**
-- The wizard stores credentials at `~/.contextstream/credentials.json` for convenience. Delete it to force a fresh login.
-- Codex CLI MCP config is global-only (`~/.codex/config.toml`), so the wizard writes Codex config globally when selected.
-- Some tools still require UI/CLI setup (the wizard will tell you when it can't write a config).
-### 2) Run the MCP Server
-**Recommended** (works well with MCP configs):
-```bash
-npx -y @contextstream/mcp-server
-```
-**Or install globally:**
-```bash
-npm install -g @contextstream/mcp-server
-contextstream-mcp
-```
-### 3) Keeping Updated
-**If you use `npx`:** Restart your AI tool/editor and run ContextStream again
-(or pin the version: `npx -y @contextstream/mcp-server@0.4.3`)
-**If you installed globally:**
-```bash
-npm update -g @contextstream/mcp-server
-```
-After updating, restart your AI tool/editor so it reloads the tool catalog.
----
-## Configure Your MCP Client (Manual)
-> If you ran the setup wizard, you can usually skip this.
-### Cursor / Windsurf / Claude Desktop (JSON)
-These clients use an `mcpServers` JSON config:
-| Client | Config path |
-|--------|-------------|
-| **Cursor** | `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project) |
-| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |
-| **Claude Desktop (macOS)** | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| **Claude Desktop (Windows)** | `%APPDATA%\Claude\claude_desktop_config.json` |
-**Consolidated (default):**
-```json
-{
-  "mcpServers": {
-    "contextstream": {
-      "command": "npx",
-      "args": ["-y", "@contextstream/mcp-server"],
-      "env": {
-        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
-        "CONTEXTSTREAM_API_KEY": "YOUR_API_KEY"
-      }
-    }
-  }
-}
-```
-**Router mode (~2 meta-tools):**
-```json
-{
-  "mcpServers": {
-    "contextstream": {
-      "command": "npx",
-      "args": ["-y", "@contextstream/mcp-server"],
-      "env": {
-        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
-        "CONTEXTSTREAM_API_KEY": "YOUR_API_KEY",
-        "CONTEXTSTREAM_PROGRESSIVE_MODE": "true"
-      }
-    }
-  }
-}
-```
-### VS Code (`.vscode/mcp.json`)
-VS Code uses a top-level `servers` map:
-```json
-{
-  "servers": {
-    "contextstream": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@contextstream/mcp-server"],
-      "env": {
-        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
-        "CONTEXTSTREAM_API_KEY": "YOUR_API_KEY"
-      }
-    }
-  }
-}
-```
-**Strong recommendation:** Use `inputs` so you don't commit secrets:
-```json
-{
-  "servers": {
-    "contextstream": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@contextstream/mcp-server"],
-      "env": {
-        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
-        "CONTEXTSTREAM_API_KEY": "${input:contextstreamApiKey}"
-      }
-    }
-  },
-  "inputs": [
-    {
-      "id": "contextstreamApiKey",
-      "type": "promptString",
-      "description": "ContextStream API Key",
-      "password": true
-    }
-  ]
-}
-```
-### Claude Code (CLI)
-**User scope (all projects):**
-```bash
-claude mcp add --transport stdio contextstream --scope user \
-  --env CONTEXTSTREAM_API_URL=https://api.contextstream.io \
-  --env CONTEXTSTREAM_API_KEY=YOUR_KEY \
-  -- npx -y @contextstream/mcp-server
-```
-**Router mode:**
-```bash
-claude mcp add --transport stdio contextstream --scope user \
-  --env CONTEXTSTREAM_API_URL=https://api.contextstream.io \
-  --env CONTEXTSTREAM_API_KEY=YOUR_KEY \
-  --env CONTEXTSTREAM_PROGRESSIVE_MODE=true \
-  -- npx -y @contextstream/mcp-server
-```
-> **Windows caveat** (native Windows, not WSL): if `npx` isn't found, use `cmd /c npx -y @contextstream/mcp-server` after `--`.
-### Codex CLI (`~/.codex/config.toml`)
-```toml
-[mcp_servers.contextstream]
-command = "npx"
-args = ["-y", "@contextstream/mcp-server"]
-[mcp_servers.contextstream.env]
-CONTEXTSTREAM_API_URL = "https://api.contextstream.io"
-CONTEXTSTREAM_API_KEY = "YOUR_API_KEY"
-```
----
-## Tool Overview (v0.4.x Consolidated)
-In consolidated mode, you call **domain tools** with `action` / `mode`:
-### Core
-| Tool | Description |
-|------|-------------|
-| `session_init` | Initialize workspace/project context |
-| `context_smart` | Retrieve the best bounded context for the current message |
-### Domain Tools
-| Tool | Description |
-|------|-------------|
-| `search` | `mode=semantic\|hybrid\|keyword\|pattern` |
-| `session` | `action=capture\|recall\|remember\|get_lessons\|capture_lesson\|...` |
-| `memory` | Events + nodes CRUD, decisions, lessons, etc. |
-| `graph` | Dependencies, impact, call_path, ingest, etc. |
-| `project` | Indexing, ingest_local, stats, files, etc. |
-| `workspace` | List, get, associate, bootstrap |
-| `reminder` | List, create, snooze, complete, dismiss |
-| `integration` | `provider=slack\|github`, search, activity, etc. |
-| `help` | Tools, auth, version, editor_rules |
-### Examples
-```
-search(mode="semantic", query="auth middleware", limit=3)
-memory(action="create_node", node_type="decision", title="Auth strategy", content="...")
-graph(action="impact", target="UserService")
-```
-**Full tool catalog:** https://contextstream.io/docs/mcp/tools
----
-## Authentication
-Set **one** of:
-| Variable | Use case |
-|----------|----------|
-| `CONTEXTSTREAM_API_KEY` | Recommended for local/dev |
-| `CONTEXTSTREAM_JWT` | Useful for hosted/user-session flows |
----
-## Environment Variables
-### Required
-| Variable | Description |
-|----------|-------------|
-| `CONTEXTSTREAM_API_URL` | Base API URL (default `https://api.contextstream.io`) |
-| `CONTEXTSTREAM_API_KEY` | API key (unless using JWT) |
-| `CONTEXTSTREAM_JWT` | JWT (unless using API key) |
-### Token + Tool Surface Controls
-| Variable | Description |
-|----------|-------------|
-| `CONTEXTSTREAM_CONSOLIDATED` | `true` (default in v0.4.x) uses consolidated domain tools |
-| `CONTEXTSTREAM_PROGRESSIVE_MODE` | Enables Router mode (~2 meta-tools) |
-| `CONTEXTSTREAM_CONTEXT_PACK` | Enable Context Pack for `context_smart` (code + graph + distill). Defaults to `true` |
-| `CONTEXTSTREAM_TOOLSET` | Legacy granular tool bundle: `light` / `standard` / `complete` (only when consolidated is off) |
-| `CONTEXTSTREAM_TOOL_ALLOWLIST` | Comma-separated tool names to expose (legacy granular mode) |
-| `CONTEXTSTREAM_SCHEMA_MODE` | Reduce schema verbosity; e.g., `compact` |
-| `CONTEXTSTREAM_OUTPUT_FORMAT` | Output formatting; e.g., `compact` / `pretty` |
-| `CONTEXTSTREAM_SEARCH_LIMIT` | Default MCP search limit (default: 3) |
-| `CONTEXTSTREAM_SEARCH_MAX_CHARS` | Max chars per search result content (default: 400) |
-### Optional Defaults
-| Variable | Description |
-|----------|-------------|
-| `CONTEXTSTREAM_WORKSPACE_ID` | Default workspace fallback |
-| `CONTEXTSTREAM_PROJECT_ID` | Default project ID fallback |
-| `CONTEXTSTREAM_USER_AGENT` | Custom user agent string |
-| `CONTEXTSTREAM_PRO_TOOLS` | Comma-separated tool names treated as PRO |
-| `CONTEXTSTREAM_UPGRADE_URL` | Upgrade link for Free users calling PRO tools |
----
-## Migration Notes (pre-0.4.x → 0.4.x)
-Most workflows **just work**, but tool names change in consolidated mode.
-| Before (granular) | After (consolidated) |
-|-------------------|----------------------|
-| `search_semantic(query="auth")` | `search(mode="semantic", query="auth")` |
-| `session_capture(...)` | `session(action="capture", ...)` |
-| `graph_dependencies(...)` | `graph(action="dependencies", ...)` |
-If you rely on granular tool names, you can temporarily set:
-```bash
-CONTEXTSTREAM_CONSOLIDATED=false
-```
----
-## Troubleshooting
-| Issue | Solution |
-|-------|----------|
-| **Tools not appearing** | Restart the client after editing MCP config; confirm Node 18+ is available in the client runtime |
-| **Unauthorized / 401** | Verify `CONTEXTSTREAM_API_URL` + `CONTEXTSTREAM_API_KEY` (or JWT) |
-| **Wrong workspace/project** | Run `session_init` and/or associate your folder with the correct workspace |
-| **Client warns about tool context size** | Use Router mode (`CONTEXTSTREAM_PROGRESSIVE_MODE=true`), or keep consolidated mode and reduce schema/output verbosity |
----
-## Development
-```bash
-git clone https://github.com/contextstream/mcp-server.git
-cd mcp-server
-npm install
-npm run dev
-npm run typecheck
-npm run build
-```
----
-## Links
-| Resource | URL |
-|----------|-----|
-| **Website** | https://contextstream.io |
-| **Docs** | https://contextstream.io/docs/mcp |
-| **Tool Catalog** | https://contextstream.io/docs/mcp/tools |
-| **Pricing** | https://contextstream.io/pricing |
-| **npm** | https://www.npmjs.com/package/@contextstream/mcp-server |
-| **GitHub** | https://github.com/contextstream/mcp-server |
----
-## License
-MIT
+# ContextStream MCP Server
+**Get set up in 30 seconds (recommended):**
+```bash
+npx -y @contextstream/mcp-server setup
+```
+This wizard authenticates you, creates/stores an API key, installs editor rules, and writes MCP config files.
+Persistent memory, semantic search, and code intelligence for any MCP-compatible AI tool (Cursor, Claude Code, Windsurf, VS Code, Claude Desktop, Codex CLI, etc.).
+**At a glance:**
+- Shared "brain" for decisions, preferences, notes (including implementation notes), lessons, tasks, and project context.
+- Search + analysis across sessions with consistent context (semantic/hybrid/keyword + graph tools).
+- v0.4.x consolidated domain tools (~11 tools) for ~75% lower tool-registry token overhead vs previous versions.
+---
+## Just Ask
+**You don't need to memorize tool names.** Describe what you want and your AI will call the right ContextStream tools:
+| You say… | ContextStream does… |
+|----------|---------------------|
+| "session summary" | Summarizes current workspace/project context |
+| "what did we decide about auth?" | Recalls decisions related to authentication |
+| "remember we're using PostgreSQL" | Captures that fact for future sessions |
+| "search for payment code" | Searches your codebase semantically/hybrid/keyword |
+| "what depends on UserService?" | Analyzes dependency graph & impact |
+> **Tip:** For best results, add the **recommended editor rules** so your AI reliably calls `session_init` / `context_smart` when appropriate:
+> https://contextstream.io/docs/quickstart
+![ContextStream in action](compare1.gif)
+---
+## Choose Your Mode (Token Footprint)
+MCP clients often inject the tool catalog into the model context. v0.4.x is designed to keep that overhead small.
+| Mode | What it exposes | Best for | Enable |
+|------|-----------------|----------|--------|
+| **Consolidated** (default) | ~11 domain tools with `action` / `mode` dispatch | Most users (recommended) | `CONTEXTSTREAM_CONSOLIDATED=true` |
+| **Router** (extreme minimization) | ~2 meta-tools (`contextstream`, `contextstream_help`) | Tight context budgets / many MCP servers | `CONTEXTSTREAM_PROGRESSIVE_MODE=true` |
+| **Legacy** (granular tools) | Older `light/standard/complete` toolsets | Back-compat / old prompts | `CONTEXTSTREAM_CONSOLIDATED=false` |
+> **Note:** The env var name for Router mode is `CONTEXTSTREAM_PROGRESSIVE_MODE` (historical naming). It enables the ~2-tool "router" surface.
+---
+## Features
+- **Consolidated domain tools** (v0.4.x): short tool list with action/mode dispatch
+- Session-aware context loading (`session_init`, `context_smart`)
+- Memory capture + recall (decisions, preferences, notes, implementation notes, lessons, tasks, bugs)
+- Code search (semantic, hybrid, keyword, pattern)
+- Knowledge graph + code analysis (dependencies, impact, call paths, circular deps, unused code)
+- Graph ingestion for full graph builds (`graph(action="ingest")`)
+- Local repo ingestion for indexing (`project(action="ingest_local")`)
+- Auto-context: on first tool call in a new session, the server can auto-initialize context
+> **⚠️ Search-First Rule:** For best results, your AI should use ContextStream `search(mode="hybrid")` **before** local tools like Glob/Grep/Read. This is enforced via editor rules and `context_smart` responses.
+---
+## Graph Tiers
+| Tier | Capabilities |
+|------|--------------|
+| **Pro (Graph-Lite)** | Module-level import graph, dependencies, and 1-hop impact |
+| **Elite/Team (Full Graph)** | Module + call + dataflow + type layers, plus full graph ingestion |
+---
+## Requirements
+- **Node.js 18+**
+- A **ContextStream account**
+- Auth via **API key** or **JWT**
+Default API URL: `https://api.contextstream.io`
+---
+## Quickstart (2 minutes)
+### 1) Run the Setup Wizard (recommended)
+The wizard:
+- Authenticates (browser/device login by default)
+- Creates/stores an API key
+- Installs recommended editor rules (optional)
+- Writes MCP config files for supported tools
+```bash
+npx -y @contextstream/mcp-server setup
+```
+**Useful flags:**
+| Flag | Description |
+|------|-------------|
+| `--dry-run` | Preview without writing files |
+**Notes:**
+- The wizard stores credentials at `~/.contextstream/credentials.json` for convenience. Delete it to force a fresh login.
+- Codex CLI MCP config is global-only (`~/.codex/config.toml`), so the wizard writes Codex config globally when selected.
+- Some tools still require UI/CLI setup (the wizard will tell you when it can't write a config).
+### 2) Run the MCP Server
+**Recommended** (works well with MCP configs):
+```bash
+npx -y @contextstream/mcp-server
+```
+**Or install globally:**
+```bash
+npm install -g @contextstream/mcp-server
+contextstream-mcp
+```
+### 3) Keeping Updated
+**If you use `npx`:** Restart your AI tool/editor and run ContextStream again
+(or pin the version: `npx -y @contextstream/mcp-server@0.4.3`)
+**If you installed globally:**
+```bash
+npm update -g @contextstream/mcp-server
+```
+After updating, restart your AI tool/editor so it reloads the tool catalog.
+---
+## Configure Your MCP Client (Manual)
+> If you ran the setup wizard, you can usually skip this.
+### Cursor / Windsurf / Claude Desktop (JSON)
+These clients use an `mcpServers` JSON config:
+| Client | Config path |
+|--------|-------------|
+| **Cursor** | `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project) |
+| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |
+| **Claude Desktop (macOS)** | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| **Claude Desktop (Windows)** | `%APPDATA%\Claude\claude_desktop_config.json` |
+**Consolidated (default):**
+```json
+{
+  "mcpServers": {
+    "contextstream": {
+      "command": "npx",
+      "args": ["-y", "@contextstream/mcp-server"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+**Router mode (~2 meta-tools):**
+```json
+{
+  "mcpServers": {
+    "contextstream": {
+      "command": "npx",
+      "args": ["-y", "@contextstream/mcp-server"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "YOUR_API_KEY",
+        "CONTEXTSTREAM_PROGRESSIVE_MODE": "true"
+      }
+    }
+  }
+}
+```
+### VS Code (`.vscode/mcp.json`)
+VS Code uses a top-level `servers` map:
+```json
+{
+  "servers": {
+    "contextstream": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@contextstream/mcp-server"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+**Strong recommendation:** Use `inputs` so you don't commit secrets:
+```json
+{
+  "servers": {
+    "contextstream": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@contextstream/mcp-server"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "${input:contextstreamApiKey}"
+      }
+    }
+  },
+  "inputs": [
+    {
+      "id": "contextstreamApiKey",
+      "type": "promptString",
+      "description": "ContextStream API Key",
+      "password": true
+    }
+  ]
+}
+```
+### Claude Code (CLI)
+**User scope (all projects):**
+```bash
+claude mcp add --transport stdio contextstream --scope user \
+  --env CONTEXTSTREAM_API_URL=https://api.contextstream.io \
+  --env CONTEXTSTREAM_API_KEY=YOUR_KEY \
+  -- npx -y @contextstream/mcp-server
+```
+**Router mode:**
+```bash
+claude mcp add --transport stdio contextstream --scope user \
+  --env CONTEXTSTREAM_API_URL=https://api.contextstream.io \
+  --env CONTEXTSTREAM_API_KEY=YOUR_KEY \
+  --env CONTEXTSTREAM_PROGRESSIVE_MODE=true \
+  -- npx -y @contextstream/mcp-server
+```
+> **Windows caveat** (native Windows, not WSL): if `npx` isn't found, use `cmd /c npx -y @contextstream/mcp-server` after `--`.
+### Codex CLI (`~/.codex/config.toml`)
+```toml
+[mcp_servers.contextstream]
+command = "npx"
+args = ["-y", "@contextstream/mcp-server"]
+[mcp_servers.contextstream.env]
+CONTEXTSTREAM_API_URL = "https://api.contextstream.io"
+CONTEXTSTREAM_API_KEY = "YOUR_API_KEY"
+```
+### Antigravity (Google)
+Antigravity uses project-scoped `.mcp.json` files with the same format as Cursor/Claude Desktop:
+**Project configuration (`.mcp.json` in project root):**
+```json
+{
+  "mcpServers": {
+    "contextstream": {
+      "command": "npx",
+      "args": ["-y", "@contextstream/mcp-server"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+**Windows users:** Use `cmd /c npx` wrapper:
+```json
+{
+  "mcpServers": {
+    "contextstream": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@contextstream/mcp-server"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+After adding the config, access via the "..." menu → "MCP Servers" → "View raw config" to verify.
+**Rules files:**
+- Global rules: `~/.gemini/GEMINI.md`
+- Workspace rules: `.agent/rules/contextstream.md`
+---
+## Tool Overview (v0.4.x Consolidated)
+In consolidated mode, you call **domain tools** with `action` / `mode`:
+### Core
+| Tool | Description |
+|------|-------------|
+| `session_init` | Initialize workspace/project context |
+| `context_smart` | Retrieve the best bounded context for the current message |
+### Domain Tools
+| Tool | Description |
+|------|-------------|
+| `search` | `mode=semantic\|hybrid\|keyword\|pattern` |
+| `session` | `action=capture\|recall\|remember\|get_lessons\|capture_lesson\|...` |
+| `memory` | Events + nodes CRUD, decisions, lessons, etc. |
+| `graph` | Dependencies, impact, call_path, ingest, etc. |
+| `project` | Indexing, ingest_local, stats, files, etc. |
+| `workspace` | List, get, associate, bootstrap |
+| `reminder` | List, create, snooze, complete, dismiss |
+| `integration` | `provider=slack\|github`, search, activity, etc. |
+| `help` | Tools, auth, version, editor_rules |
+### Examples
+```
+search(mode="semantic", query="auth middleware", limit=3)
+memory(action="create_node", node_type="decision", title="Auth strategy", content="...")
+graph(action="impact", target="UserService")
+```
+**Full tool catalog:** https://contextstream.io/docs/mcp/tools
+---
+## Authentication
+Set **one** of:
+| Variable | Use case |
+|----------|----------|
+| `CONTEXTSTREAM_API_KEY` | Recommended for local/dev |
+| `CONTEXTSTREAM_JWT` | Useful for hosted/user-session flows |
+---
+## Environment Variables
+### Required
+| Variable | Description |
+|----------|-------------|
+| `CONTEXTSTREAM_API_URL` | Base API URL (default `https://api.contextstream.io`) |
+| `CONTEXTSTREAM_API_KEY` | API key (unless using JWT) |
+| `CONTEXTSTREAM_JWT` | JWT (unless using API key) |
+### Token + Tool Surface Controls
+| Variable | Description |
+|----------|-------------|
+| `CONTEXTSTREAM_CONSOLIDATED` | `true` (default in v0.4.x) uses consolidated domain tools |
+| `CONTEXTSTREAM_PROGRESSIVE_MODE` | Enables Router mode (~2 meta-tools) |
+| `CONTEXTSTREAM_CONTEXT_PACK` | Enable Context Pack for `context_smart` (code + graph + distill). Defaults to `true` |
+| `CONTEXTSTREAM_TOOLSET` | Legacy granular tool bundle: `light` / `standard` / `complete` (only when consolidated is off) |
+| `CONTEXTSTREAM_TOOL_ALLOWLIST` | Comma-separated tool names to expose (legacy granular mode) |
+| `CONTEXTSTREAM_SCHEMA_MODE` | Reduce schema verbosity; e.g., `compact` |
+| `CONTEXTSTREAM_OUTPUT_FORMAT` | Output formatting; e.g., `compact` / `pretty` |
+| `CONTEXTSTREAM_SEARCH_LIMIT` | Default MCP search limit (default: 3) |
+| `CONTEXTSTREAM_SEARCH_MAX_CHARS` | Max chars per search result content (default: 400) |
+### Optional Defaults
+| Variable | Description |
+|----------|-------------|
+| `CONTEXTSTREAM_WORKSPACE_ID` | Default workspace fallback |
+| `CONTEXTSTREAM_PROJECT_ID` | Default project ID fallback |
+| `CONTEXTSTREAM_USER_AGENT` | Custom user agent string |
+| `CONTEXTSTREAM_PRO_TOOLS` | Comma-separated tool names treated as PRO |
+| `CONTEXTSTREAM_UPGRADE_URL` | Upgrade link for Free users calling PRO tools |
+---
+## Migration Notes (pre-0.4.x → 0.4.x)
+Most workflows **just work**, but tool names change in consolidated mode.
+| Before (granular) | After (consolidated) |
+|-------------------|----------------------|
+| `search_semantic(query="auth")` | `search(mode="semantic", query="auth")` |
+| `session_capture(...)` | `session(action="capture", ...)` |
+| `graph_dependencies(...)` | `graph(action="dependencies", ...)` |
+If you rely on granular tool names, you can temporarily set:
+```bash
+CONTEXTSTREAM_CONSOLIDATED=false
+```
+---
+## Troubleshooting
+| Issue | Solution |
+|-------|----------|
+| **Tools not appearing** | Restart the client after editing MCP config; confirm Node 18+ is available in the client runtime |
+| **Unauthorized / 401** | Verify `CONTEXTSTREAM_API_URL` + `CONTEXTSTREAM_API_KEY` (or JWT) |
+| **Wrong workspace/project** | Run `session_init` and/or associate your folder with the correct workspace |
+| **Client warns about tool context size** | Use Router mode (`CONTEXTSTREAM_PROGRESSIVE_MODE=true`), or keep consolidated mode and reduce schema/output verbosity |
+---
+## Development
+```bash
+git clone https://github.com/contextstream/mcp-server.git
+cd mcp-server
+npm install
+npm run dev
+npm run typecheck
+npm run build
+```
+---
+## Links
+| Resource | URL |
+|----------|-----|
+| **Website** | https://contextstream.io |
+| **Docs** | https://contextstream.io/docs/mcp |
+| **Tool Catalog** | https://contextstream.io/docs/mcp/tools |
+| **Pricing** | https://contextstream.io/pricing |
+| **npm** | https://www.npmjs.com/package/@contextstream/mcp-server |
+| **GitHub** | https://github.com/contextstream/mcp-server |
+---
+## License
+MIT

package/dist/index.js CHANGED Viewed

@@ -8447,6 +8447,13 @@ ${rules}
 # Add ContextStream guidance to conventions
 conventions: |
 ${rules.split("\n").map((line) => "  " + line).join("\n")}
+`
+  },
+  antigravity: {
+    filename: "GEMINI.md",
+    description: "Google Antigravity AI rules",
+    build: (rules) => `# Antigravity Agent Rules
+${rules}
 `
   }
 };
@@ -17874,10 +17881,11 @@ var EDITOR_LABELS = {
   cline: "Cline",
   kilo: "Kilo Code",
   roo: "Roo Code",
-  aider: "Aider"
+  aider: "Aider",
+  antigravity: "Antigravity (Google)"
 };
 function supportsProjectMcpConfig(editor) {
-  return editor === "cursor" || editor === "claude" || editor === "kilo" || editor === "roo";
+  return editor === "cursor" || editor === "claude" || editor === "kilo" || editor === "roo" || editor === "antigravity";
 }
 function normalizeInput(value) {
   return value.trim();
@@ -18100,6 +18108,8 @@ function globalRulesPathForEditor(editor) {
       return path6.join(home, ".roo", "rules", "contextstream.md");
     case "aider":
       return path6.join(home, ".aider.conf.yml");
+    case "antigravity":
+      return path6.join(home, ".gemini", "GEMINI.md");
     case "cursor":
       return null;
     default:
@@ -18202,6 +18212,29 @@ async function isCursorInstalled() {
   }
   return anyPathExists(candidates);
 }
+async function isAntigravityInstalled() {
+  const home = homedir4();
+  const candidates = [path6.join(home, ".gemini")];
+  if (process.platform === "darwin") {
+    candidates.push("/Applications/Antigravity.app");
+    candidates.push(path6.join(home, "Applications", "Antigravity.app"));
+    candidates.push(path6.join(home, "Library", "Application Support", "Antigravity"));
+  } else if (process.platform === "win32") {
+    const localApp = process.env.LOCALAPPDATA;
+    const programFiles = process.env.ProgramFiles;
+    const programFilesX86 = process.env["ProgramFiles(x86)"];
+    if (localApp) candidates.push(path6.join(localApp, "Programs", "Antigravity", "Antigravity.exe"));
+    if (localApp) candidates.push(path6.join(localApp, "Antigravity", "Antigravity.exe"));
+    if (programFiles) candidates.push(path6.join(programFiles, "Antigravity", "Antigravity.exe"));
+    if (programFilesX86) candidates.push(path6.join(programFilesX86, "Antigravity", "Antigravity.exe"));
+  } else {
+    candidates.push("/usr/bin/antigravity");
+    candidates.push("/usr/local/bin/antigravity");
+    candidates.push("/opt/Antigravity");
+    candidates.push("/opt/antigravity");
+  }
+  return anyPathExists(candidates);
+}
 async function isEditorInstalled(editor) {
   switch (editor) {
     case "codex":
@@ -18220,6 +18253,8 @@ async function isEditorInstalled(editor) {
       return isRooInstalled();
     case "aider":
       return isAiderInstalled();
+    case "antigravity":
+      return isAntigravityInstalled();
     default:
       return false;
   }
@@ -18734,7 +18769,8 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
       "cline",
       "kilo",
       "roo",
-      "aider"
+      "aider",
+      "antigravity"
     ];
     console.log('\nSelect editors to configure (comma-separated numbers, or "all"):');
     editors.forEach((e, i) => console.log(`  ${i + 1}) ${EDITOR_LABELS[e]}`));

package/package.json CHANGED Viewed

@@ -1,70 +1,70 @@
-{
-  "name": "@contextstream/mcp-server",
-  "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.29",
-  "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
-  "type": "module",
-  "license": "MIT",
-  "main": "dist/index.js",
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "bin": {
-    "contextstream-mcp": "dist/index.js"
-  },
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --format=esm --external:@modelcontextprotocol/sdk --banner:js=\"#!/usr/bin/env node\" && esbuild src/test-server.ts --bundle --platform=node --target=node18 --outfile=dist/test-server.js --format=esm --external:@modelcontextprotocol/sdk",
-    "start": "node dist/index.js",
-    "test-server": "tsx src/test-server.ts",
-    "test-server:start": "node dist/test-server.js",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "format": "prettier --write src/",
-    "format:check": "prettier --check src/"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.1",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "@types/node": "^20.10.0",
-    "@typescript-eslint/eslint-plugin": "^8.52.0",
-    "@typescript-eslint/parser": "^8.52.0",
-    "esbuild": "^0.27.0",
-    "eslint": "^9.39.2",
-    "prettier": "^3.7.4",
-    "tsx": "^4.15.4",
-    "typescript": "^5.6.3",
-    "typescript-eslint": "^8.52.0",
-    "vitest": "^4.0.16"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "contextstream",
-    "ai",
-    "code-context",
-    "memory",
-    "knowledge-graph"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/contextstream/mcp-server.git"
-  },
-  "homepage": "https://contextstream.io/docs/mcp",
-  "bugs": {
-    "url": "https://github.com/contextstream/mcp-server/issues"
-  },
-  "overrides": {
-    "qs": "6.14.1"
-  }
-}
+{
+  "name": "@contextstream/mcp-server",
+  "mcpName": "io.github.contextstreamio/mcp-server",
+  "version": "0.4.30",
+  "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
+  "type": "module",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "contextstream-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --format=esm --external:@modelcontextprotocol/sdk --banner:js=\"#!/usr/bin/env node\" && esbuild src/test-server.ts --bundle --platform=node --target=node18 --outfile=dist/test-server.js --format=esm --external:@modelcontextprotocol/sdk",
+    "start": "node dist/index.js",
+    "test-server": "tsx src/test-server.ts",
+    "test-server:start": "node dist/test-server.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.52.0",
+    "@typescript-eslint/parser": "^8.52.0",
+    "esbuild": "^0.27.0",
+    "eslint": "^9.39.2",
+    "prettier": "^3.7.4",
+    "tsx": "^4.15.4",
+    "typescript": "^5.6.3",
+    "typescript-eslint": "^8.52.0",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "contextstream",
+    "ai",
+    "code-context",
+    "memory",
+    "knowledge-graph"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/contextstream/mcp-server.git"
+  },
+  "homepage": "https://contextstream.io/docs/mcp",
+  "bugs": {
+    "url": "https://github.com/contextstream/mcp-server/issues"
+  },
+  "overrides": {
+    "qs": "6.14.1"
+  }
+}