chain-insights 0.42.2 → 0.43.1

package/README.md

@@ -61,8 +61,9 @@ The `plugin/` folder is the Chain Insights plugin for Claude. It starts the
 local Chain Insights MCP proxy on your computer over stdio
 (`chain-insights-mcp-proxy` from the npm package, through `npx`), and brings the
 `chain-insights-cypher` and `chain-insights-schema-evm` skills. The proxy
-serves the money-flow, query-table and balance views itself, and reaches the
-Chain Insights Graph for the data.
+serves the views itself (a graph, a chart or a table, picked from the column
+names of a `graph_query` answer, and the balance), and reaches the Chain
+Insights Graph for the data.
 
 - **Runs in:** Claude Desktop, Cowork sessions on your computer, and Claude Code.
 - **Cannot start it:** claude.ai on the web, the Claude mobile apps and Cowork
@@ -71,9 +72,21 @@ Chain Insights Graph for the data.
 The plugin needs Node.js 22 or newer. Add this repository as a plugin
 marketplace, then install the `chain-insights` plugin from it.
 
-Without the plugin, `npm install -g chain-insights` then
-`cia setup claude-desktop` registers the installed proxy in Claude Desktop
-directly. Restart Claude Desktop afterwards.
+Without the plugin, register the installed proxy in Claude Desktop directly:
+
+1. Quit Claude Desktop fully. Closing the window is not enough: it keeps
+   running and writes its settings file back, which can remove the new entry.
+   - macOS: Claude menu > Quit Claude (Cmd+Q).
+   - Windows: right-click the Claude icon in the taskbar tray > Quit.
+   - Linux: File menu > Quit, or the tray icon > Quit.
+2. Run `npm install -g chain-insights`, then `cia setup claude-desktop`.
+   It warns if Claude Desktop is still running.
+3. Start Claude Desktop. `chain-insights` shows under Settings > Developer.
+
+The entry is written to `claude_desktop_config.json` under `mcpServers`:
+`~/Library/Application Support/Claude` on macOS, `%APPDATA%\Claude` on
+Windows, `~/.config/Claude` on Linux. A `.bak` copy of the previous file is
+kept beside it.
 
 The plugin skills are copies of `skills/`. After editing a skill, run
 `node scripts/sync-plugin-skills.mjs`; a test fails while the copies differ.

package/bin/install.cjs

@@ -318,8 +318,34 @@ function installClaudeDesktopMcp(configFile, proxyPath) {
   fs.writeFileSync(configFile, `${JSON.stringify(config, null, 2)}\n`, 'utf8')
 }
 
+// Claude Desktop keeps its settings in the same file and writes the whole file
+// back when it saves them, so an entry added while it runs can be lost.
+function claudeDesktopRunning() {
+  const { spawnSync } = require('child_process')
+  try {
+    if (process.platform === 'win32') {
+      const out = spawnSync('tasklist', ['/FI', 'IMAGENAME eq Claude.exe', '/NH'], { encoding: 'utf8' })
+      return /claude\.exe/i.test(out.stdout || '')
+    }
+    const pgrepArgs = process.platform === 'darwin' ? ['-x', 'Claude'] : ['-f', '(^|/)claude-desktop( |$)']
+    return spawnSync('pgrep', pgrepArgs, { encoding: 'utf8' }).status === 0
+  } catch {
+    return false
+  }
+}
+
+function quitClaudeDesktopHint() {
+  if (process.platform === 'darwin') return 'Claude menu > Quit Claude (Cmd+Q)'
+  if (process.platform === 'win32') return 'right-click the Claude icon in the taskbar tray > Quit'
+  return 'File menu > Quit, or the tray icon > Quit'
+}
+
 if (hasClaudeDesktop) {
   const desktopConfig = claudeDesktopConfigPath()
+  if (claudeDesktopRunning()) {
+    console.log(`  ${bold}Claude Desktop is running.${reset} It can overwrite the new entry when it saves its own settings.`)
+    console.log(`  Quit it fully (${quitClaudeDesktopHint()}), run ${cyan}cia setup claude-desktop${reset} again, then start Claude Desktop.`)
+  }
   try {
     installClaudeDesktopMcp(desktopConfig, proxyBinPath)
     console.log(`  ${cyan}Claude Desktop MCP:${reset} registered in ${desktopConfig}`)