@stupidloud/codegraph 0.7.14 → 0.7.20

package/README.md

@@ -2,7 +2,7 @@
 
 # CodeGraph
 
-### Supercharge Claude Code with Semantic Code Intelligence
+### Supercharge Claude Code, Cursor, Codex, and OpenCode with Semantic Code Intelligence
 
 **94% fewer tool calls · 77% faster exploration · 100% local**
 
@@ -13,6 +13,10 @@
 [![Windows](https://img.shields.io/badge/Windows-supported-blue.svg)](#)
 [![macOS](https://img.shields.io/badge/macOS-supported-blue.svg)](#)
 [![Linux](https://img.shields.io/badge/Linux-supported-blue.svg)](#)
+[![Claude Code](https://img.shields.io/badge/Claude_Code-supported-blueviolet.svg)](#)
+[![Cursor](https://img.shields.io/badge/Cursor-supported-blueviolet.svg)](#)
+[![Codex CLI](https://img.shields.io/badge/Codex_CLI-supported-blueviolet.svg)](#)
+[![opencode](https://img.shields.io/badge/opencode-supported-blueviolet.svg)](#)
 
 [English](./README.md) · [简体中文](./README.zh-CN.md)
 
@@ -24,7 +28,7 @@
 npx @stupidloud/codegraph
 ```
 
-<sub>Interactive installer configures Claude Code automatically</sub>
+<sub>Interactive installer auto-configures your agent(s) — Claude Code, Cursor, Codex CLI, opencode</sub>
 
 #### Initialize Projects
 
@@ -151,15 +155,33 @@ npx @stupidloud/codegraph
 ```
 
 The installer will:
-- Prompt to install `codegraph` globally (needed for the MCP server)
-- Configure the MCP server in `~/.claude.json`
-- Set up auto-allow permissions for CodeGraph tools
-- Add global instructions to `~/.claude/CLAUDE.md`
-- Optionally initialize your current project
+- Ask which agent(s) to configure — auto-detects installed ones from: **Claude Code**, **Cursor**, **Codex CLI**, **opencode**
+- Prompt to install `codegraph` on your PATH (so agents can launch the MCP server)
+- Ask whether configs apply to all your projects or just this one
+- Write each chosen agent's MCP server config + an instructions file (e.g. `CLAUDE.md`, `.cursor/rules/codegraph.mdc`, `~/.codex/AGENTS.md`)
+- Set up auto-allow permissions when Claude Code is one of the targets
+- Initialize your current project (local installs only)
 
-### 2. Restart Claude Code
+**Non-interactive (scripting / CI):**
 
-Restart Claude Code for the MCP server to load.
+```bash
+codegraph install --yes                              # auto-detect agents, install global
+codegraph install --target=cursor,claude --yes       # explicit target list
+codegraph install --target=auto --location=local     # detected agents, project-local
+codegraph install --print-config codex               # print snippet, no file writes
+```
+
+| Flag | Values | Default |
+|---|---|---|
+| `--target` | `auto`, `all`, `none`, or csv (`claude,cursor,...`) | prompt |
+| `--location` | `global`, `local` | prompt |
+| `--yes` | (boolean) | prompt every step |
+| `--no-permissions` | (boolean) skip Claude auto-allow list | permissions on |
+| `--print-config <id>` | dump snippet for one agent and exit | — |
+
+### 2. Restart Your Agent
+
+Restart your agent (Claude Code / Cursor / Codex CLI / opencode) for the MCP server to load.
 
 ### 3. Initialize Projects
 
@@ -168,7 +190,9 @@ cd your-project
 codegraph init -i
 ```
 
-That's it! Claude Code will use CodeGraph tools automatically when a `.codegraph/` directory exists.
+Builds the per-project knowledge graph index. Also wires up any project-local agent surfaces (e.g. Cursor's `.cursor/rules/codegraph.mdc`) so a single global `codegraph install` works in every project you open — no need to re-run the installer per project.
+
+That's it — your agent will use CodeGraph tools automatically when a `.codegraph/` directory exists.
 
 <details>
 <summary><strong>Manual Setup (Alternative)</strong></summary>
@@ -469,6 +493,16 @@ The `.codegraph/config.json` file controls indexing:
 
 **Missing symbols** — The MCP server auto-syncs on save (wait a couple seconds). Run `codegraph sync` manually if needed. Check that the file's language is supported and isn't excluded by config patterns.
 
+## Star History
+
+<a href="https://www.star-history.com/?repos=colbymchenry%2Fcodegraph&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=colbymchenry/codegraph&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=colbymchenry/codegraph&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=colbymchenry/codegraph&type=date&legend=top-left" />
+ </picture>
+</a>
+
 ## License
 
 MIT

package/README.zh-CN.md

@@ -53,8 +53,7 @@ Gemini API key / Jina API key
     "enabled": true,
     "provider": "gemini",
     "apiKey": "YOUR_GEMINI_API_KEY",
-    "model": "gemini-embedding-001",
-    "outputDimensionality": 768,
+    "model": "gemini-embedding-2",
     "batchSize": 32
   }
 }
@@ -69,7 +68,6 @@ Jina 示例：
     "provider": "jina",
     "apiKey": "YOUR_JINA_API_KEY",
     "model": "jina-embeddings-v5-text-nano",
-    "outputDimensionality": 768,
     "batchSize": 32
   }
 }
@@ -150,7 +148,6 @@ const cg = await CodeGraph.init('/path/to/project', {
       provider: 'jina',
       apiKey: process.env.JINA_API_KEY,
       model: 'jina-embeddings-v5-text-nano',
-      outputDimensionality: 768,
       batchSize: 32,
     },
   },
@@ -184,8 +181,7 @@ cg.close();
   "semanticSearch": {
     "enabled": false,
     "provider": "gemini",
-    "model": "gemini-embedding-001",
-    "outputDimensionality": 768,
+    "model": "gemini-embedding-2",
     "batchSize": 32
   }
 }
@@ -202,8 +198,7 @@ cg.close();
 | `semanticSearch.enabled` | 是否启用远程 embedding 语义搜索 |
 | `semanticSearch.provider` | `gemini` 或 `jina` |
 | `semanticSearch.apiKey` | Provider API key |
-| `semanticSearch.model` | Gemini 默认 `gemini-embedding-001`；Jina 默认 `jina-embeddings-v5-text-nano` |
-| `semanticSearch.outputDimensionality` | 默认 `768` |
+| `semanticSearch.model` | Gemini 默认 `gemini-embedding-2`；Jina 默认 `jina-embeddings-v5-text-nano` |
 | `semanticSearch.batchSize` | 每批生成多少个节点 embedding |
 
 ## 支持语言

package/dist/bin/codegraph.js

@@ -58,6 +58,7 @@ const fs = __importStar(require("fs"));
 const child_process_1 = require("child_process");
 const directory_1 = require("../directory");
 const shimmer_progress_1 = require("../ui/shimmer-progress");
+const glyphs_1 = require("../ui/glyphs");
 const node_version_check_1 = require("./node-version-check");
 // Lazy-load heavy modules (CodeGraph, runInstaller) to keep CLI startup fast.
 async function loadCodeGraph() {
@@ -66,7 +67,7 @@ async function loadCodeGraph() {
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
-        console.error('\x1b[31m✗\x1b[0m Failed to load CodeGraph modules.');
+        console.error(`\x1b[31m${(0, glyphs_1.getGlyphs)().err}\x1b[0m Failed to load CodeGraph modules.`);
         console.error(`\n  Node: ${process.version}  Platform: ${process.platform} ${process.arch}`);
         console.error(`\n  Error: ${msg}`);
         console.error('\n  Try reinstalling with: npm install -g @stupidloud/codegraph\n');
@@ -204,12 +205,14 @@ function main() {
     function createVerboseProgress() {
         let lastPhase = '';
         let lastPct = -1;
+        let lastDetail = '';
         const startTime = Date.now();
         return (progress) => {
             const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
             if (progress.phase !== lastPhase) {
                 lastPhase = progress.phase;
                 lastPct = -1;
+                lastDetail = '';
                 console.log(`[${elapsed}s] Phase: ${progress.phase}`);
             }
             if (progress.total > 0) {
@@ -217,7 +220,13 @@ function main() {
                 // Log every 5% to keep output manageable
                 if (pct >= lastPct + 5 || progress.current === progress.total) {
                     lastPct = pct;
-                    console.log(`[${elapsed}s]   ${progress.current}/${progress.total} (${pct}%)${progress.currentFile ? ` — ${progress.currentFile}` : ''}`);
+                    console.log(`[${elapsed}s]   ${progress.current}/${progress.total} (${pct}%)${progress.currentFile ? ` ${(0, glyphs_1.getGlyphs)().dash} ${progress.currentFile}` : ''}`);
+                }
+            }
+            else if (progress.currentFile) {
+                if (progress.currentFile !== lastDetail) {
+                    lastDetail = progress.currentFile;
+                    console.log(`[${elapsed}s]   ${progress.currentFile}`);
                 }
             }
             else if (progress.current > 0) {
@@ -232,25 +241,25 @@ function main() {
      * Print success message
      */
     function success(message) {
-        console.log(chalk.green('✓') + ' ' + message);
+        console.log(chalk.green((0, glyphs_1.getGlyphs)().ok) + ' ' + message);
     }
     /**
      * Print error message
      */
     function error(message) {
-        console.error(chalk.red('✗') + ' ' + message);
+        console.error(chalk.red((0, glyphs_1.getGlyphs)().err) + ' ' + message);
     }
     /**
      * Print info message
      */
     function info(message) {
-        console.log(chalk.blue('ℹ') + ' ' + message);
+        console.log(chalk.blue((0, glyphs_1.getGlyphs)().info) + ' ' + message);
     }
     /**
      * Print warning message
      */
     function warn(message) {
-        console.log(chalk.yellow('⚠') + ' ' + message);
+        console.log(chalk.yellow((0, glyphs_1.getGlyphs)().warn) + ' ' + message);
     }
     /**
      * Print indexing results using clack log methods
@@ -270,7 +279,7 @@ function main() {
         // continuing to the misleading "No files found" branch or throwing.
         if (!result.success && !hasErrors && result.filesIndexed === 0) {
             const generic = result.errors.find((e) => e.severity === 'error');
-            clack.log.error(generic?.message ?? 'Indexing failed — no further details available');
+            clack.log.error(generic?.message ?? `Indexing failed ${(0, glyphs_1.getGlyphs)().dash} no further details available`);
             return;
         }
         if (result.filesIndexed > 0) {
@@ -283,7 +292,7 @@ function main() {
             clack.log.info(`${formatNumber(result.nodesCreated)} nodes, ${formatNumber(result.edgesCreated)} edges in ${formatDuration(result.durationMs)}`);
         }
         else if (hasErrors) {
-            clack.log.error(`Indexing failed — all ${formatNumber(result.filesErrored)} files had errors`);
+            clack.log.error(`Indexing failed ${(0, glyphs_1.getGlyphs)().dash} all ${formatNumber(result.filesErrored)} files had errors`);
         }
         else {
             clack.log.warn('No files found to index');
@@ -313,7 +322,7 @@ function main() {
                 clack.log.info('See .codegraph/errors.log for details');
             }
             if (result.filesIndexed > 0) {
-                clack.log.info('The index is fully usable — only the failed files are missing.');
+                clack.log.info(`The index is fully usable ${(0, glyphs_1.getGlyphs)().dash} only the failed files are missing.`);
             }
         }
         else if (projectPath) {
@@ -350,7 +359,7 @@ function main() {
             }
         }
         const lines = [
-            `CodeGraph Error Log — ${new Date().toISOString()}`,
+            `CodeGraph Error Log - ${new Date().toISOString()}`,
             `${errorsByFile.size} files with errors`,
             '',
         ];
@@ -383,6 +392,16 @@ function main() {
             if ((0, directory_1.isInitialized)(projectPath)) {
                 clack.log.warn(`Already initialized in ${projectPath}`);
                 clack.log.info('Use "codegraph index" to re-index or "codegraph sync" to update');
+                // Re-run agent surface wiring so re-running `init` is the
+                // documented way to recover a project that's missing its
+                // Cursor rules file (or future per-agent project surfaces).
+                try {
+                    const { wireProjectSurfacesForGlobalAgents } = await Promise.resolve().then(() => __importStar(require('../installer')));
+                    for (const { target, file } of wireProjectSurfacesForGlobalAgents()) {
+                        clack.log.success(`${target.displayName}: ${file.action} ${file.path}`);
+                    }
+                }
+                catch { /* non-fatal */ }
                 clack.outro('');
                 return;
             }
@@ -394,6 +413,20 @@ function main() {
                 config: semanticConfig,
             });
             clack.log.success(`Initialized in ${projectPath}`);
+            // Bootstrap project-local surfaces for any agent that's
+            // configured globally (Cursor needs ./.cursor/rules/codegraph.mdc
+            // to actually prefer codegraph over native grep). Silent when
+            // there's nothing to write.
+            try {
+                const { wireProjectSurfacesForGlobalAgents } = await Promise.resolve().then(() => __importStar(require('../installer')));
+                for (const { target, file } of wireProjectSurfacesForGlobalAgents()) {
+                    clack.log.success(`${target.displayName}: ${file.action} ${file.path}`);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                clack.log.warn(`Skipped wiring project-local agent surfaces: ${msg}`);
+            }
             if (options.index) {
                 let result;
                 if (options.verbose) {
@@ -403,7 +436,7 @@ function main() {
                     });
                 }
                 else {
-                    process.stdout.write(`${colors.dim}│${colors.reset}\n`);
+                    process.stdout.write(`${colors.dim}${(0, glyphs_1.getGlyphs)().rail}${colors.reset}\n`);
                     const progress = (0, shimmer_progress_1.createShimmerProgress)();
                     result = await cg.indexAll({
                         onProgress: progress.onProgress,
@@ -442,7 +475,7 @@ function main() {
                 const readline = await Promise.resolve().then(() => __importStar(require('readline')));
                 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
                 const answer = await new Promise((resolve) => {
-                    rl.question(chalk.yellow('⚠ This will permanently delete all CodeGraph data. Continue? (y/N) '), resolve);
+                    rl.question(chalk.yellow(`${(0, glyphs_1.getGlyphs)().warn} This will permanently delete all CodeGraph data. Continue? (y/N) `), resolve);
                 });
                 rl.close();
                 if (answer.toLowerCase() !== 'y') {
@@ -503,7 +536,7 @@ function main() {
                 });
             }
             else {
-                process.stdout.write(`${colors.dim}│${colors.reset}\n`);
+                process.stdout.write(`${colors.dim}${(0, glyphs_1.getGlyphs)().rail}${colors.reset}\n`);
                 const progress = (0, shimmer_progress_1.createShimmerProgress)();
                 result = await cg.indexAll({
                     onProgress: progress.onProgress,
@@ -547,7 +580,7 @@ function main() {
             }
             const clack = await importESM('@clack/prompts');
             clack.intro('Syncing CodeGraph');
-            process.stdout.write(`${colors.dim}│${colors.reset}\n`);
+            process.stdout.write(`${colors.dim}${(0, glyphs_1.getGlyphs)().rail}${colors.reset}\n`);
             const progress = (0, shimmer_progress_1.createShimmerProgress)();
             const result = await cg.sync({
                 onProgress: progress.onProgress,
@@ -566,7 +599,7 @@ function main() {
                     details.push(`Modified: ${result.filesModified}`);
                 if (result.filesRemoved > 0)
                     details.push(`Removed: ${result.filesRemoved}`);
-                clack.log.info(`${details.join(', ')} — ${formatNumber(result.nodesUpdated)} nodes in ${formatDuration(result.durationMs)}`);
+                clack.log.info(`${details.join(', ')} ${(0, glyphs_1.getGlyphs)().dash} ${formatNumber(result.nodesUpdated)} nodes in ${formatDuration(result.durationMs)}`);
             }
             clack.outro('Done');
             cg.destroy();
@@ -641,7 +674,7 @@ function main() {
             // when the native build fails.
             const backendLabel = backend === 'native'
                 ? chalk.green('native')
-                : chalk.yellow('wasm — slower fallback; run `npm rebuild better-sqlite3`');
+                : chalk.yellow(`wasm ${(0, glyphs_1.getGlyphs)().dash} slower fallback; run \`npm rebuild better-sqlite3\``);
             console.log(`  Backend:   ${backendLabel}`);
             console.log();
             // Node breakdown
@@ -886,8 +919,9 @@ function main() {
         const renderNode = (node, prefix, isLast, depth) => {
             if (maxDepth !== undefined && depth > maxDepth)
                 return;
-            const connector = isLast ? '└── ' : '├── ';
-            const childPrefix = isLast ? '    ' : '│   ';
+            const glyphs = (0, glyphs_1.getGlyphs)();
+            const connector = isLast ? glyphs.treeLast : glyphs.treeBranch;
+            const childPrefix = isLast ? '    ' : glyphs.treePipe;
             if (node.name) {
                 let line = prefix + connector + node.name;
                 if (node.file && includeMetadata) {
@@ -968,7 +1002,7 @@ function main() {
                 // Default: show info about MCP mode.
                 // Use stderr so stdout stays clean for any piped/stdio usage.
                 console.error(chalk.bold('\nCodeGraph MCP Server\n'));
-                console.error(chalk.blue('ℹ') + ' Use --mcp flag to start the MCP server');
+                console.error(chalk.blue((0, glyphs_1.getGlyphs)().info) + ' Use --mcp flag to start the MCP server');
                 console.error('\nTo use with Claude Code, add to your MCP configuration:');
                 console.error(chalk.dim(`
 {
@@ -1144,7 +1178,7 @@ function main() {
             }
             const lockPath = path.join((0, directory_1.getCodeGraphDir)(projectPath), 'codegraph.lock');
             if (!fs.existsSync(lockPath)) {
-                info('No lock file found — nothing to do');
+                info(`No lock file found ${(0, glyphs_1.getGlyphs)().dash} nothing to do`);
                 return;
             }
             fs.unlinkSync(lockPath);
@@ -1290,10 +1324,54 @@ function main() {
      */
     program
         .command('install')
-        .description('Run interactive installer for Claude Code integration')
-        .action(async () => {
-        const { runInstaller } = await Promise.resolve().then(() => __importStar(require('../installer')));
-        await runInstaller();
+        .description('Install codegraph MCP server into one or more agents (Claude Code, Cursor, Codex CLI, opencode)')
+        .option('-t, --target <ids>', 'Target agent(s): comma-separated ids, or "auto"|"all"|"none". Default: prompt')
+        .option('-l, --location <where>', 'Install location: "global" or "local". Default: prompt')
+        .option('-y, --yes', 'Non-interactive: defaults to --location=global --target=auto, auto-allow on')
+        .option('--no-permissions', 'Skip writing the auto-allow permissions list (Claude Code only)')
+        .option('--print-config <id>', 'Print MCP config snippet for the named agent and exit (no file writes)')
+        .action(async (opts) => {
+        if (opts.printConfig) {
+            const { getTarget, listTargetIds } = await Promise.resolve().then(() => __importStar(require('../installer/targets/registry')));
+            const target = getTarget(opts.printConfig);
+            if (!target) {
+                const known = listTargetIds().join(', ');
+                error(`Unknown target "${opts.printConfig}". Known: ${known}.`);
+                process.exit(1);
+            }
+            const loc = (opts.location === 'local' ? 'local' : 'global');
+            process.stdout.write(target.printConfig(loc));
+            return;
+        }
+        const { runInstallerWithOptions } = await Promise.resolve().then(() => __importStar(require('../installer')));
+        if (opts.location && opts.location !== 'global' && opts.location !== 'local') {
+            error(`--location must be "global" or "local" (got "${opts.location}").`);
+            process.exit(1);
+        }
+        try {
+            // Commander's `--no-permissions` makes `opts.permissions === false`;
+            // omitting the flag leaves it `true` (the positive-form default).
+            // We MUST treat the default-true as "user did not override — let
+            // the orchestrator prompt" and only forward an explicit `false`
+            // (or `true` when --yes implies it). Otherwise the auto-allow
+            // prompt is silently skipped on every interactive run.
+            const explicitNoPermissions = opts.permissions === false;
+            const autoAllow = explicitNoPermissions
+                ? false
+                : opts.yes
+                    ? true
+                    : undefined;
+            await runInstallerWithOptions({
+                target: opts.target,
+                location: opts.location,
+                autoAllow,
+                yes: opts.yes,
+            });
+        }
+        catch (err) {
+            error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
     });
     // Parse and run
     program.parse();