@triedotdev/mcp 1.0.29 → 1.0.31

package/README.md

@@ -88,6 +88,16 @@ claude mcp add Trie --scope user -- npx @triedotdev/mcp
 
 **Restart Claude Code after adding the MCP server.**
 
+### Other MCP-Compatible Tools
+
+Trie works with any MCP-compatible AI tool (OpenCode, Windsurf, etc.). Configure your tool to run:
+
+```bash
+npx @triedotdev/mcp
+```
+
+Trie auto-detects which tool is running and adapts its output format accordingly.
+
 ---
 
 ## Usage
@@ -120,14 +130,11 @@ Trie works in two modes:
 
 **Enable AI mode:**
 
-```bash
-# Environment variable
-export ANTHROPIC_API_KEY=sk-ant-...
+**For MCP usage (Cursor/Claude Code):**
 
-# Or add it to your project (recommended for CLI usage)
-echo 'ANTHROPIC_API_KEY=sk-ant-...' >> .env.local
+Add the API key to your MCP configuration:
 
-# Or in MCP config (Cursor / MCP tools)
+```json
 {
   "mcpServers": {
     "Trie": {
@@ -141,8 +148,28 @@ echo 'ANTHROPIC_API_KEY=sk-ant-...' >> .env.local
 }
 ```
 
-> **Important:** The `env` you set in Cursor’s MCP config is only inherited by the **MCP server process** that Cursor launches.
-> It does **not** automatically apply to standalone terminal commands like `trie-agent scan` unless your shell/project environment also has `ANTHROPIC_API_KEY`.
+**For CLI usage (terminal/CI):**
+
+Add the API key to your project's `.env.local` file (in your project root):
+
+```bash
+echo 'ANTHROPIC_API_KEY=sk-ant-...' >> .env.local
+```
+
+Then load it before running CLI commands:
+
+```bash
+# Load environment variables
+set -a; source .env.local; set +a
+
+# Now run CLI commands
+trie-agent scan
+```
+
+> **Important:** 
+> - **MCP config** (`env` in mcp.json) only applies to the MCP server process launched by Cursor/Claude Code
+> - **CLI commands** (`trie-agent scan`, `trie-agent watch`) need the key in your shell environment (via `.env.local` or `export`)
+> - The MCP server and CLI are separate processes with separate environments
 
 When AI is enabled, you'll see:
 - `AI-powered analysis enabled` in output
@@ -153,27 +180,54 @@ When AI is enabled, you'll see:
 
 ## CLI
 
-Trie includes a powerful CLI for terminal-based scanning.
+Trie includes a CLI for terminal-based scanning and CI/CD integration. The CLI generates reports with actionable issues—it does not auto-fix code. Use Cursor or Claude Code to apply fixes based on the reports.
+
+> **Note:** The CLI is separate from MCP tools. Use MCP tools (`trie_scan`, `trie_watch`) when working inside Cursor/Claude Code. Use the CLI (`trie-agent scan`, `trie-agent watch`) for terminal/CI usage.
 
 ### Commands
 
 ```bash
-# Basic scan
+# Basic scan (generates report and exits)
 trie-agent scan
 
-# Watch for changes
+# Watch for changes (continuously scans and reports)
 trie-agent watch
 
 # Scan specific directory
-trie-agent scan --directory ./src
+trie-agent scan --dir ./src
 
 # Scan specific files
 trie-agent scan --files "src/api.ts,src/auth.ts"
 
 # Run specific agents
 trie-agent scan --agents security,privacy,bugs
+
+# Output JSON report
+trie-agent scan --format json --output report.json
 ```
 
+### CLI vs MCP Tools
+
+| Use Case | Tool | When to Use |
+|----------|------|-------------|
+| **Interactive coding** | MCP tools (`trie_scan`, `trie_watch`) | Working inside Cursor/Claude Code |
+| **Terminal/CI** | CLI (`trie-agent scan`, `trie-agent watch`) | Running from terminal, CI pipelines, scripts |
+| **VS Code** | VS Code extension | Using VS Code (not Cursor/Claude Code) |
+
+Both generate the same reports—they're just different interfaces to the same scanning engine.
+
+---
+
+## How It Works
+
+Trie generates **actionable reports** with high-confidence issues. It does not auto-fix code. Instead:
+
+1. **Trie scans** your code and generates a report with prioritized issues
+2. **You review** the issues in the report (or share with Cursor/Claude Code)
+3. **You (or Cursor/Claude Code)** apply fixes based on Trie's recommendations
+
+This keeps you in control while providing comprehensive issue detection. Trie focuses on **finding and reporting** issues—you decide how to fix them.
+
 ---
 
 ## CI/CD Integration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triedotdev/mcp",
-  "version": "1.0.29",
+  "version": "1.0.31",
   "description": "Intelligent Agent Orchestration for AI Coding Tools",
   "main": "dist/index.js",
   "type": "module",