@takara-ai/miru-code 0.4.5 → 0.4.6

package/README.md

@@ -25,7 +25,7 @@ miru setup --key YOUR_TOKEN   # non-interactive
 miru setup --clear            # remove stored key
 ```
 
-MCP loads your key from `credentials.json` automatically. Set `TAKARA_API_KEY` in MCP config only to override.
+MCP loads your key from `credentials.json` automatically — no env block needed in MCP config.
 
 ## Add to your IDE
 
@@ -39,7 +39,7 @@ Interactive — pick your agent and what to enable (MCP, instructions, sub-agent
 miru uninstall   # remove miru config
 ```
 
-**Supported:** Cursor · Claude Code · Gemini CLI · Kiro · OpenCode · GitHub Copilot · Codex · VS Code
+**Supported:** Cursor · Claude Code · Gemini CLI · Kiro · OpenCode · GitHub Copilot · Codex · VS Code · Visual Studio (Windows)
 
 | IDE | Config written by `miru install` |
 |-----|----------------------------------|
@@ -50,6 +50,7 @@ miru uninstall   # remove miru config
 | OpenCode | `~/.config/opencode/opencode.json(c)` + agents dir |
 | GitHub Copilot | `~/.copilot/mcp-config.json` + `~/.copilot/agents/miru-code.agent.md` |
 | Codex / VS Code | MCP config only |
+| Visual Studio | `%USERPROFILE%\.mcp.json` (Windows, Copilot Agent Mode) |
 
 **Team sub-agent in a repo** (optional):
 
@@ -132,12 +133,13 @@ See `.env.example` for more.
 {
   "miru": {
     "command": "miru",
-    "args": [],
-    "env": { "TAKARA_API_KEY": "your-token" }
+    "args": []
   }
 }
 ```
 
+Run `miru setup` once so the server can load your key from `credentials.json`.
+
 Use `bunx` + `@takara-ai/miru-code` if `miru` is not global. Wrapper key varies by IDE (`mcpServers`, `servers`, or `mcp`).
 
 ## Developing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takara-ai/miru-code",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Miru (見る) — hybrid code search for agents. Bun, TypeScript, Takara embeddings.",
   "type": "module",
   "license": "MIT",

package/src/cache.ts

@@ -1,7 +1,6 @@
 import { createHash } from "node:crypto";
 import { rm } from "node:fs/promises";
 import { join } from "node:path";
-import { computeSourceCacheKey } from "./utils.ts";
 import { resolveEmbeddingDimensions, resolveEmbeddingModel } from "./embeddings/openai.ts";
 import {
   loadBm25,
@@ -13,6 +12,7 @@ import {
 import { resolveSemanticStorage, semanticStorageFromMetadata } from "./index/vector-storage.ts";
 import type { Chunk, ContentType } from "./types.ts";
 import { chunkFromDict } from "./types.ts";
+import { computeSourceCacheKey } from "./utils.ts";
 
 export function resolveCacheFolder(): string {
   const name = "miru";

package/src/cli.ts

@@ -11,8 +11,8 @@ import {
   success,
 } from "./cli-ui.ts";
 import { loadStoredCredentials } from "./credentials.ts";
-import { loadEnvFiles } from "./env-files.ts";
 import { normalizeTakaraApiKeyEnv } from "./env.ts";
+import { loadEnvFiles } from "./env-files.ts";
 import {
   AGENT_IDS,
   formatUnknownAgent,

package/src/env.ts

@@ -33,7 +33,8 @@ export function envOptionalInt(names: string[], min = 1): number | undefined {
 
 export const TAKARA_API_KEY_ENV = "TAKARA_API_KEY";
 
-const TAKARA_API_KEY_PLACEHOLDERS = new Set(["${TAKARA_API_KEY}", "$TAKARA_API_KEY"]);
+const MCP_KEY_PLACEHOLDER = "$" + "{TAKARA_API_KEY}";
+const TAKARA_API_KEY_PLACEHOLDERS = new Set([MCP_KEY_PLACEHOLDER, "$TAKARA_API_KEY"]);
 
 /** True when the value is a real key, not empty or an unexpanded MCP env placeholder. */
 export function isUsableTakaraApiKey(value: string | undefined): boolean {

package/src/installer/agents.ts

@@ -1,4 +1,5 @@
 import { existsSync } from "node:fs";
+import { readdir } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import type { AgentId } from "../agents.ts";
@@ -19,30 +20,21 @@ export const MIRU_END = "<!-- miru:end -->";
 
 const HOME = homedir();
 
-const TAKARA_KEY_PLACEHOLDER = "$" + "{TAKARA_API_KEY}";
-
-const MCP_ENV: Record<string, string> = {
-  TAKARA_API_KEY: TAKARA_KEY_PLACEHOLDER,
-};
-
 const STDIO_SERVER_CONFIG: Record<string, unknown> = {
   command: "bunx",
   args: ["@takara-ai/miru-code"],
   type: "stdio",
-  env: MCP_ENV,
 };
 
 const BARE_STDIO_SERVER_CONFIG: Record<string, unknown> = {
   command: "bunx",
   args: ["@takara-ai/miru-code"],
-  env: MCP_ENV,
 };
 
 const OPENCODE_SERVER_CONFIG: Record<string, unknown> = {
   command: ["bunx", "@takara-ai/miru-code"],
   type: "local",
   enabled: true,
-  environment: MCP_ENV,
 };
 
 export const INSTRUCTIONS = `${MIRU_START}
@@ -54,7 +46,7 @@ A \`miru\` MCP server is available with two tools:
 
 Always call \`search\` before using Grep, Glob, or Read to explore the codebase. Use Grep/Glob/Read only for exact path lookup, exhaustive literal matches, or when the returned chunk lacks enough context.
 
-Run \`miru setup\` once to store your API key — the MCP server loads it from \`credentials.json\`. Optionally set \`TAKARA_API_KEY\` in MCP config to override.
+Run \`miru setup\` once to store your API key — the MCP server loads it from \`credentials.json\` automatically.
 
 Pass \`--content docs\` to search documentation, \`--content config\` for config files, or \`--content all\` for everything.
 
@@ -92,7 +84,7 @@ export interface McpConfig {
 }
 
 export interface AgentTarget {
-  id: AgentId | "codex" | "vscode";
+  id: AgentId | "codex" | "vscode" | "visualstudio";
   displayName: string;
   binary: string | null;
   configDir: string | null;
@@ -128,6 +120,45 @@ export function vscodeMcpPath(): string {
   return join(xdg, "Code", "User", "mcp.json");
 }
 
+/** Global MCP config for Visual Studio (GitHub Copilot Agent Mode). */
+export function visualStudioMcpPath(): string {
+  const profile = process.env.USERPROFILE ?? HOME;
+  return join(profile, ".mcp.json");
+}
+
+export function visualStudioInstallDir(): string | null {
+  if (process.platform !== "win32") {
+    return null;
+  }
+  const programFiles = process.env.ProgramFiles ?? join("C:", "Program Files");
+  return join(programFiles, "Microsoft Visual Studio");
+}
+
+async function detectVisualStudio(): Promise<boolean> {
+  if (process.platform !== "win32") {
+    return false;
+  }
+
+  const installDir = visualStudioInstallDir();
+  if (installDir && existsSync(installDir)) {
+    try {
+      const entries = await readdir(installDir);
+      if (entries.length > 0) {
+        return true;
+      }
+    } catch {
+      // ignore unreadable install directory
+    }
+  }
+
+  try {
+    const proc = Bun.spawn(["where", "devenv"], { stdout: "pipe", stderr: "ignore" });
+    return (await proc.exited) === 0;
+  } catch {
+    return false;
+  }
+}
+
 function jsonMcp(path: string, key: string, entry: Record<string, unknown>): McpConfig {
   return { path, key, memberKey: "miru", entry, format: "json" };
 }
@@ -171,7 +202,6 @@ export const AGENT_TARGETS: AgentTarget[] = [
     mcp: jsonMcp(join(HOME, ".kiro", "settings", "mcp.json"), "mcpServers", {
       ...STDIO_SERVER_CONFIG,
       env: {
-        ...MCP_ENV,
         PATH: "/usr/local/bin:/usr/bin:/bin",
       },
     }),
@@ -225,19 +255,34 @@ export const AGENT_TARGETS: AgentTarget[] = [
     subagentPath: null,
     subagentId: null,
   },
+  {
+    id: "visualstudio",
+    displayName: process.platform === "win32" ? "Visual Studio" : "Visual Studio (Windows)",
+    binary: null,
+    configDir: visualStudioInstallDir(),
+    mcp: jsonMcp(visualStudioMcpPath(), "servers", STDIO_SERVER_CONFIG),
+    instructionsPath: null,
+    subagentPath: null,
+    subagentId: null,
+  },
 ];
 
+async function commandOnPath(command: string): Promise<boolean> {
+  const lookup = process.platform === "win32" ? ["where", command] : ["which", command];
+  try {
+    const proc = Bun.spawn(lookup, { stdout: "pipe", stderr: "ignore" });
+    return (await proc.exited) === 0;
+  } catch {
+    return false;
+  }
+}
+
 export async function isAgentDetected(agent: AgentTarget): Promise<boolean> {
-  if (agent.binary) {
-    try {
-      const proc = Bun.spawn(["which", agent.binary], { stdout: "pipe", stderr: "ignore" });
-      const code = await proc.exited;
-      if (code === 0) {
-        return true;
-      }
-    } catch {
-      // which unavailable
-    }
+  if (agent.id === "visualstudio") {
+    return detectVisualStudio();
+  }
+  if (agent.binary && (await commandOnPath(agent.binary))) {
+    return true;
   }
   if (agent.configDir) {
     return Bun.file(agent.configDir).exists();

package/src/installer/config.ts

@@ -6,7 +6,6 @@ const CODEX_MCP_HEADER = "[mcp_servers.miru]";
 const CODEX_MCP_BLOCK = `[mcp_servers.miru]
 command = "bunx"
 args = ["@takara-ai/miru-code"]
-env = { TAKARA_API_KEY = "\${TAKARA_API_KEY}" }
 `;
 
 /** Strip line and block comments so JSONC configs can be parsed. */