@codemap-ai/cli 0.1.5 → 0.1.8

package/README.md

@@ -1,6 +1,6 @@
 # @codemap-ai/cli
 
-AI-powered code intelligence and coding agent CLI. Provides an MCP server for code exploration, symbol analysis, and refactoring — plus an interactive chat agent powered by LLM gateways.
+AI-powered coding agent CLI. Interactive chat agent powered by LLM gateways, with code exploration, symbol analysis, and refactoring capabilities.
 
 ## Quick Start
 
@@ -13,91 +13,6 @@ npm install -g @codemap-ai/cli
 codemap
 ```
 
-## MCP Server Setup
-
-CodeMap runs as an MCP (Model Context Protocol) server that plugs into AI coding agents. Pick your editor:
-
-### Claude Code
-
-```bash
-claude mcp add codemap-mcp -- npx -y @codemap-ai/cli
-```
-
-### Cursor
-
-Create or edit `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "codemap-mcp": {
-      "command": "npx",
-      "args": ["-y", "@codemap-ai/cli"]
-    }
-  }
-}
-```
-
-Then restart Cursor.
-
-### Codex
-
-Add to `~/.codex/config.toml`:
-
-```toml
-[mcp_servers.codemap]
-command = "npx"
-args = ["-y", "@codemap-ai/cli"]
-```
-
-### Gemini CLI
-
-Edit `~/.gemini/settings.json`:
-
-```json
-{
-  "mcpServers": {
-    "codemap-mcp": {
-      "command": "npx",
-      "args": ["-y", "@codemap-ai/cli"]
-    }
-  }
-}
-```
-
-### GitHub Copilot (VS Code)
-
-Create or edit `.vscode/mcp.json`:
-
-```json
-{
-  "servers": {
-    "codemap-mcp": {
-      "command": "npx",
-      "args": ["-y", "@codemap-ai/cli"]
-    }
-  }
-}
-```
-
-Then reload VS Code.
-
-### OpenCode
-
-Edit `opencode.json` in your project root:
-
-```json
-{
-  "mcp": {
-    "codemap-mcp": {
-      "command": "npx",
-      "args": ["-y", "@codemap-ai/cli"],
-      "enabled": true
-    }
-  }
-}
-```
-
 ## Authentication
 
 ```bash
@@ -112,49 +27,57 @@ codemap logout     # Clear credentials
 
 ```bash
 codemap                    # Interactive chat (default)
+codemap chat               # Interactive chat (explicit)
 codemap ask "explain X"    # Single prompt, exit
 codemap route "task"       # Show which model handles a task
 codemap models             # List available models
 codemap doctor             # Diagnose gateway config
-codemap init-gateway       # Create gateway config
+codemap init-gateway       # Create gateway config file (--project | --global)
+                           #   --base-url <url>   Override gateway base URL
+                           #   --force            Overwrite existing config
 ```
 
 ### Workspace
 
 ```bash
-codemap status             # Git, index, auth, project status
-codemap local-index        # Build/update local code index
-codemap local-index --force  # Full rebuild
+codemap status               # Git, index, auth, project status
+codemap local-index          # Build/update local code index
+  --force                    # Full rebuild
+  --status                   # Show index info without rebuilding
 ```
 
 ### Agent Pack (Editor Integration)
 
 ```bash
-codemap init-agent-pack --target claude   # Install rules for Claude Code
-codemap init-agent-pack --target all      # Install for all supported editors
-codemap doctor-agent-pack                 # Check installation health
-codemap onboarding --target cursor        # Print setup guide
+codemap init-agent-pack      # Install CodeMap agent rules into an editor
+  --target <editor>          # claude | cursor | codex | gemini | opencode | copilot | all
+  --root <dir>               # Workspace root (default: cwd)
+  --dry-run                  # Preview without writing
+
+codemap doctor-agent-pack    # Check agent pack installation health
+  --target <editor>          # Editor to check (default: auto-detect)
+  --root <dir>               # Workspace root
+
+codemap agent-pack-path      # Print the agent pack plugin root path
+
+codemap clean-agent-pack-backups  # Remove backup files left by upgrades
+  --root <dir>               # Workspace root
+  --dry-run                  # Preview without deleting
+
+codemap onboarding           # Print setup guide for an editor
+  --target <editor>          # claude | cursor | codex | gemini | opencode | copilot | all
 ```
 
-## MCP Tools
-
-When running as an MCP server, CodeMap exposes these tools to your AI agent:
-
-| Tool | Description |
-|---|---|
-| `explore_task` | Broad task exploration — returns likely files, entrypoints, symbols, risks |
-| `search_codebase` | Find files, symbols, exports by keyword or semantic query |
-| `get_file` | Read file with outline, symbol bodies, or blast radius analysis |
-| `symbol` | Inspect a symbol — context, usages, callers, similar |
-| `find_related_files` | Multi-signal ranking of files related to a query or file |
-| `get_project_map` | Browse file tree |
-| `get_project_insights` | Codebase health: orphans, cycles, top files by dependency |
-| `diff` | Git diff — working tree or between refs |
-| `move_symbols` | Move symbols between files, auto-update imports |
-| `rename_symbol` | Rename symbol codebase-wide |
-| `reimport` | Trigger cloud re-indexing |
-| `refresh_local_index` | Refresh local SQLite index |
-| `web_search` / `web_fetch` | Search and fetch web documentation |
+### Claude Code Hooks
+
+These are called automatically by Claude Code hook config, not by hand:
+
+```bash
+codemap session-hint         # Emit index status hint on session start
+codemap pre-edit             # Emit blast radius hint before a file edit
+codemap pre-read             # Emit index hint before a file read
+codemap pre-bash             # Emit search hint before a bash command
+```
 
 ## Gateway Configuration
 
@@ -164,13 +87,16 @@ CodeMap uses an LLM gateway for chat and agent features. Configure via environme
 CODEMAP_LLM_GATEWAY_BASE_URL=http://localhost:4000/v1
 CODEMAP_LLM_GATEWAY_API_KEY=your-key
 CODEMAP_LLM_GATEWAY_DEFAULT_PROFILE=coder
+CODEMAP_LLM_GATEWAY_CODER_MODEL=model-name
+CODEMAP_LLM_GATEWAY_PLANNER_MODEL=model-name
+CODEMAP_LLM_GATEWAY_REVIEWER_MODEL=model-name
 ```
 
 Or create a config file at `.codemap/llm-gateway.json` (project) or `~/.codemap/llm-gateway.json` (user).
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 22+
 - Git (for repository features)
 
 ## License

package/dist/{chat-terminal-7KX3PEP3.js → chat-terminal-4KYTQ5XZ.js}

@@ -1,7 +1,7 @@
 import{createRequire as __cmr}from"node:module";import{fileURLToPath as __f2p}from"node:url";import{dirname as __dn}from"node:path";var require=__cmr(import.meta.url);var __filename=__f2p(import.meta.url);var __dirname=__dn(__filename);
 import {
   fetchResourceContext
-} from "./chunk-MF6QRGI5.js";
+} from "./chunk-7NZT33JN.js";
 import {
   executeCommand,
   getCachedContext,
@@ -10,7 +10,7 @@ import {
   loadThreadIntoUI,
   runShell,
   warmupFileSearch
-} from "./chunk-EUHYFJ32.js";
+} from "./chunk-XBXR7XCX.js";
 import {
   buildLocalIndex,
   getMastraCurrentModelId,
@@ -26,13 +26,13 @@ import {
   switchMastraThread,
   tryGetCurrentWorkspaceInfo,
   warmupHarness
-} from "./chunk-GGIXJZYK.js";
+} from "./chunk-57JG7UZE.js";
 import {
   C_ERROR,
   C_SUCCESS,
   RESET
 } from "./chunk-YRXVMFXS.js";
-import "./chunk-AXGGL47C.js";
+import "./chunk-4F6G2Q7W.js";
 
 // src/cli-agent/chat/ui/chat-terminal.ts
 import path2 from "path";
@@ -998,7 +998,7 @@ var ChatTerminal = class {
   // ─── Start ───────────────────────────────────────────────
   async start() {
     if (!this.options.apiToken && this.options.mcpConfig) {
-      const { showLoginScreen } = await import("./login-screen-2DJBDM47.js");
+      const { showLoginScreen } = await import("./login-screen-3EAZNNE2.js");
       const result = await showLoginScreen(this.options.mcpConfig);
       if (result === "exit") return;
     }
@@ -1020,12 +1020,15 @@ var ChatTerminal = class {
     });
     this.store.dispatch({ synthRunning: true });
     this.bus.scheduleRefresh();
-    loadOrSynthesizeAll(this.options.provider, this.store.getState().config.model).catch(() => {
+    loadOrSynthesizeAll(
+      this.options.provider,
+      this.store.getState().config.model
+    ).catch(() => {
     }).finally(() => {
       this.store.dispatch({ synthRunning: false });
       this.bus.scheduleRefresh();
     });
-    const { startPiTuiApp } = await import("./pi-tui-app-DCD7TEN5.js");
+    const { startPiTuiApp } = await import("./pi-tui-app-QZCEQTPW.js");
     await startPiTuiApp(this);
   }
   // ─── Session management ───────────────────────────────────
@@ -1343,7 +1346,11 @@ var ChatTerminal = class {
         );
         if (!this.isActiveTask(taskId, taskAbort)) return;
         this.store.dispatch({
-          task: { ...this.store.getState().task, phase: "thinking", effort: classification.effort }
+          task: {
+            ...this.store.getState().task,
+            phase: "thinking",
+            effort: classification.effort
+          }
         });
         this.bus.scheduleRefresh();
       }
@@ -1354,7 +1361,10 @@ var ChatTerminal = class {
         });
       } else {
         this.store.dispatch({
-          task: { ...this.store.getState().task, effort: classification.effort }
+          task: {
+            ...this.store.getState().task,
+            effort: classification.effort
+          }
         });
       }
       const [sessionResourceCtx, sessionProjectCtx] = await Promise.all([
@@ -1390,7 +1400,12 @@ var ChatTerminal = class {
           if (!this.isActiveTask(taskId, taskAbort)) return;
           resetStreaming();
           this.store.dispatch({
-            task: { ...this.store.getState().task, phase, model, effort: "high" }
+            task: {
+              ...this.store.getState().task,
+              phase,
+              model,
+              effort: "high"
+            }
           });
           this.bus.scheduleRefresh();
         },