githits 0.2.1 → 0.2.2

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "GitHits plugins for Claude Code - code examples from global open source",
-    "version": "0.2.1"
+    "version": "0.2.2"
   },
   "plugins": [
     {

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Code examples from global open source for developers and AI assistants",
   "author": {
     "name": "GitHits"

package/.plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Code examples from global open source for developers and AI assistants",
   "author": {
     "name": "GitHits"

package/GEMINI.md

@@ -11,12 +11,12 @@ Find code examples from open source repositories.
 **Parameters:**
 
 - `query` (string, required) - natural language description of what you need
-- `language` (string, required) - programming language name (use `search_language` to verify)
+- `language` (string, optional) - programming language name; omit it to let GitHits infer the language from the query
 - `license_mode` (string, optional) - one of `strict` (default), `yolo`, or `custom`
 
 ### search_language
 
-Look up supported programming language names. Use this before calling `get_example` to get the correct language identifier.
+Look up supported programming language names. Use this before calling `get_example` only when you need to force a specific language and the exact name is uncertain.
 
 **Parameters:**
 
@@ -60,7 +60,7 @@ Do not use `get_example` for:
 
 ## How to Search Well
 
-- Call `search_language` first to confirm the correct language name before calling `get_example`
+- Pass `language` only when you need to force a specific language; call `search_language` first if the exact language name is uncertain
 - Formulate queries as natural language questions (e.g., "How to stream responses with the Vercel AI SDK in Next.js")
 - Include specific error messages, library names, or API names when relevant
 - Keep queries focused: 3-4 technical terms maximum

package/commands/example.md

@@ -6,16 +6,17 @@ description: Search for canonical code examples from open source via GitHits
 
 Search for code examples using GitHits for the query: "$ARGUMENTS"
 
-Use the GitHits MCP `get_example` tool with the user's query. The tool requires two
-parameters:
+Use the GitHits MCP `get_example` tool with the user's query.
+
+Required parameter:
 
 - **query**: The user's search query, formulated in natural language.
-- **language**: The programming language. If the language is unclear from
-  context, use the `search_language` tool first to find the correct language
-  name.
 
-Optional parameter:
+Optional parameters:
 
+- **language**: The programming language. Omit it to let GitHits infer the
+  language from the query. If you need to force a specific language and the
+  exact name is uncertain, use the `search_language` tool first.
 - **license_mode**: `"strict"` (default, excludes copyleft), `"yolo"` (all
   licenses), or `"custom"` (user's blocklist).
 

package/commands/help.md

@@ -28,9 +28,9 @@ context summary:
 This plugin connects to the GitHits MCP server and always exposes three core tools:
 
 - **get_example** — Find code examples by describing what you need in natural
-  language. Requires `query` and `language` parameters.
-- **search_language** — Look up supported programming language names before
-  searching.
+  language. Requires `query`; `language` is optional and inferred when omitted.
+- **search_language** — Look up supported programming language names when you
+  need to force a specific language.
 - **feedback** — Rate a search result to improve future quality.
 
 Additional indexed dependency/package tools such as `search`, `package_summary`,

package/commands/search.md

@@ -8,16 +8,17 @@ Use GitHits example search for the query: "$ARGUMENTS"
 
 This slash command is the older alias for `/githits:example`.
 
-Use the GitHits MCP `get_example` tool with the user's query. The tool requires two
-parameters:
+Use the GitHits MCP `get_example` tool with the user's query.
+
+Required parameter:
 
 - **query**: The user's search query, formulated in natural language.
-- **language**: The programming language. If the language is unclear from
-  context, use the `search_language` tool first to find the correct language
-  name.
 
-Optional parameter:
+Optional parameters:
 
+- **language**: The programming language. Omit it to let GitHits infer the
+  language from the query. If you need to force a specific language and the
+  exact name is uncertain, use the `search_language` tool first.
 - **license_mode**: `"strict"` (default, excludes copyleft), `"yolo"` (all
   licenses), or `"custom"` (user's blocklist).
 

package/dist/cli.js

@@ -41,11 +41,11 @@ import {
   setMcpClientVersionProvider,
   startTelemetrySpan,
   withTelemetrySpan
-} from "./shared/chunk-ykr7x8jp.js";
+} from "./shared/chunk-ns1j9dan.js";
 import {
   __require,
   version
-} from "./shared/chunk-szjytcvw.js";
+} from "./shared/chunk-g6ay6x9v.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -4140,7 +4140,7 @@ grep run. --symbol-field hydrates enclosing symbol metadata (appears under each
 match in --verbose output; full payload in --json).`;
 function registerCodeGrepCommand(pkgCommand) {
   return pkgCommand.command("grep").summary("Deterministic text grep over indexed dependency source").description(PKG_GREP_DESCRIPTION).argument("[spec-or-pattern]", "Spec mode: package spec (e.g. npm:express). Repo mode (with --repo-url): the pattern.").argument("[pattern-or-prefix]", "Spec mode: the pattern. Repo mode: optional path-prefix.").argument("[path-prefix]", "Spec mode only: optional path-prefix. Ignored with --repo-url.").option("--repo-url <url>", "Repository URL addressing (requires --git-ref)").option("--git-ref <ref>", "Tag, commit, branch, or HEAD. Required with --repo-url.").option("--path <path>", "Exact file path to grep").option("--glob <glob>", "Glob scope (repeatable)", collectRepeatable, []).option("--ext <ext>", "Extension filter without leading dot (repeatable)", collectRepeatable, []).option("--regex", "Interpret the pattern as RE2 regex").option("--case-sensitive", "Enable ASCII case-sensitive matching").option("-C, --context <n>", "Context lines before and after each match (0-10)").option("-B, --before-context <n>", "Context lines before each match (0-10)").option("-A, --after-context <n>", "Context lines after each match (0-10)").option("--exclude-docs", "Skip files classified as documentation").option("--exclude-tests", "Skip files classified as tests").option("--limit <n>", "Max matches to return on this page (1-1000, default 50)").option("--per-file-limit <n>", "Cap matches per file within this page (0-1000, 0 = unlimited)").option("--cursor <cursor>", "Opaque nextCursor from a previous grep result").option("--symbol-field <field>", `Repeatable; surfaces in --json and under each --verbose match. ${GREP_REPO_SYMBOL_FIELDS_NOTE}`, collectRepeatable, []).option("--wait <ms>", `Indexing wait timeout (0-${MAX_WAIT_TIMEOUT_MS}, default ${DEFAULT_WAIT_TIMEOUT_MS})`).option("-v, --verbose", "Render grouped output with file headers").option("--json", "Emit the JSON envelope").action(async (arg1, arg2, arg3, options) => {
-    const { createContainer: createContainer2 } = await import("./shared/chunk-67qnnqby.js");
+    const { createContainer: createContainer2 } = await import("./shared/chunk-4drb8s8v.js");
     const deps = await createContainer2();
     await pkgGrepAction(arg1, arg2, arg3, options, {
       codeNavigationService: deps.codeNavigationService,
@@ -4639,12 +4639,13 @@ var EXAMPLE_DESCRIPTION = `Get verified, canonical code examples from global ope
 For dependency, package, or repository source search, use \`githits search\` instead.
 
 Examples:
+  githits example "how to use express middleware"
   githits example "how to use express middleware" --lang javascript
   githits example "async file reading" -l python --license yolo
   githits example "react hooks patterns" -l typescript --explain
   githits example "react hooks patterns" -l typescript --json`;
 function registerExampleCommand(program) {
-  program.command("example").summary("Get code examples from global open source").description(EXAMPLE_DESCRIPTION).argument("<query>", "Natural language example-search query").requiredOption("-l, --lang <language>", "Programming language").addOption(new Option("--license <mode>", "License filter mode").choices(["strict", "yolo", "custom"]).default(undefined)).option("--explain", "Include AI-generated explanation").option("--json", "Output as JSON for piping").action(async (query, options) => {
+  program.command("example").summary("Get code examples from global open source").description(EXAMPLE_DESCRIPTION).argument("<query>", "Natural language example-search query").option("-l, --lang <language>", "Optional programming language; omitted values are inferred by GitHits").addOption(new Option("--license <mode>", "License filter mode").choices(["strict", "yolo", "custom"]).default(undefined)).option("--explain", "Include AI-generated explanation").option("--json", "Output as JSON for piping").action(async (query, options) => {
     try {
       const deps = await loadContainer();
       await exampleAction(query, options, deps);
@@ -4656,7 +4657,7 @@ function registerExampleCommand(program) {
   });
 }
 async function loadContainer() {
-  const { createContainer: createContainer2 } = await import("./shared/chunk-67qnnqby.js");
+  const { createContainer: createContainer2 } = await import("./shared/chunk-4drb8s8v.js");
   return createContainer2();
 }
 // src/commands/feedback.ts
@@ -4706,6 +4707,62 @@ function registerFeedbackCommand(program) {
   });
 }
 // src/commands/init/setup-handlers.ts
+import {
+  parse as parseJsonc,
+  printParseErrorCode
+} from "jsonc-parser";
+function parseConfigObject(content) {
+  let normalizedContent = content;
+  if (normalizedContent.charCodeAt(0) === 65279) {
+    normalizedContent = normalizedContent.slice(1);
+  }
+  const trimmed = normalizedContent.trim();
+  if (trimmed === "") {
+    return {
+      format: "json",
+      value: {}
+    };
+  }
+  try {
+    const parsed = JSON.parse(normalizedContent);
+    if (!isPlainObject(parsed)) {
+      return {
+        format: "invalid",
+        error: "Config file root is not a JSON object"
+      };
+    }
+    return {
+      format: "json",
+      value: parsed
+    };
+  } catch (jsonError) {
+    const parseErrors = [];
+    const parsed = parseJsonc(normalizedContent, parseErrors, {
+      allowTrailingComma: true,
+      disallowComments: false,
+      allowEmptyContent: false
+    });
+    if (parseErrors.length > 0) {
+      const firstParseError = parseErrors[0];
+      const strictErrorMessage = jsonError instanceof Error ? jsonError.message : String(jsonError);
+      const jsoncDetail = firstParseError ? `${printParseErrorCode(firstParseError.error)} at offset ${firstParseError.offset}` : "Unknown parse error";
+      return {
+        format: "invalid",
+        error: `Invalid JSON: ${strictErrorMessage}. JSONC parse error: ${jsoncDetail}`
+      };
+    }
+    if (!isPlainObject(parsed)) {
+      return {
+        format: "invalid",
+        error: "Config file root is not a JSON object"
+      };
+    }
+    return {
+      format: "jsonc",
+      value: parsed
+    };
+  }
+}
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -4814,29 +4871,14 @@ function getMatchingServerKeys(servers, serverName) {
   return Object.keys(servers).filter((key) => key.toLowerCase() === normalizedTarget);
 }
 function mergeServerConfig(existingContent, serversKey, serverName, serverConfig) {
-  let content = existingContent;
-  if (content.charCodeAt(0) === 65279) {
-    content = content.slice(1);
-  }
-  const trimmed = content.trim();
-  if (trimmed === "") {
-    content = "{}";
-  }
-  let config;
-  try {
-    config = JSON.parse(content);
-  } catch (err) {
+  const parsedConfig = parseConfigObject(existingContent);
+  if (parsedConfig.format === "invalid") {
     return {
       status: "parse_error",
-      error: `Invalid JSON: ${err instanceof Error ? err.message : String(err)}`
-    };
-  }
-  if (typeof config !== "object" || config === null || Array.isArray(config)) {
-    return {
-      status: "parse_error",
-      error: "Config file root is not a JSON object"
+      error: parsedConfig.error
     };
   }
+  const config = parsedConfig.value;
   if (!(serversKey in config)) {
     config[serversKey] = {};
   }
@@ -4875,23 +4917,12 @@ ${snippet}`;
 }
 async function isAlreadyConfigured(config, fs) {
   try {
-    let content;
-    try {
-      content = await fs.readFile(config.configPath);
-    } catch {
-      return false;
-    }
-    if (content.charCodeAt(0) === 65279) {
-      content = content.slice(1);
-    }
-    const trimmed = content.trim();
-    if (trimmed === "") {
-      return false;
-    }
-    const parsed = JSON.parse(trimmed);
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    const content = await fs.readFile(config.configPath);
+    const parsedConfig = parseConfigObject(content);
+    if (parsedConfig.format === "invalid") {
       return false;
     }
+    const parsed = parsedConfig.value;
     const servers = parsed[config.serversKey];
     if (typeof servers !== "object" || servers === null || Array.isArray(servers)) {
       return false;
@@ -5049,6 +5080,32 @@ function getAppDataPath(fs, appName) {
       return fs.joinPath(home, ".config", appName);
   }
 }
+function getUserDataRoot(fs) {
+  const home = fs.getHomeDir();
+  switch (process.platform) {
+    case "win32":
+      return process.env.APPDATA ?? fs.joinPath(home, "AppData", "Roaming");
+    case "darwin":
+      return fs.joinPath(home, "Library", "Application Support");
+    default:
+      return process.env.XDG_DATA_HOME ?? fs.joinPath(home, ".local", "share");
+  }
+}
+function getOpenCodeConfigDir(fs) {
+  if (process.platform === "win32") {
+    return fs.joinPath(getUserDataRoot(fs), "opencode");
+  }
+  return fs.joinPath(fs.getHomeDir(), ".config", "opencode");
+}
+function getOpenCodeDesktopDetectPaths(fs) {
+  const userDataRoot = getUserDataRoot(fs);
+  return [
+    fs.joinPath(userDataRoot, "ai.opencode.desktop"),
+    fs.joinPath(userDataRoot, "ai.opencode.desktop.beta"),
+    fs.joinPath(userDataRoot, "ai.opencode.desktop.dev"),
+    getOpenCodeConfigDir(fs)
+  ];
+}
 async function isExecutableAvailable(exec, executable) {
   try {
     const lookupCommand = process.platform === "win32" ? "where" : "which";
@@ -5261,12 +5318,13 @@ var googleAntigravity = {
 var openCode = {
   name: "OpenCode",
   id: "opencode",
-  detectionMethod: "binary",
+  detectionMethod: "hybrid",
   setupMethod: "config-file",
+  detectPaths: (fs) => getOpenCodeDesktopDetectPaths(fs),
   detectBinary: async (exec) => isExecutableAvailable(exec, "opencode"),
   getSetupConfig: (fs) => ({
     method: "config-file",
-    configPath: process.platform === "win32" ? fs.joinPath(process.env.APPDATA ?? fs.joinPath(fs.getHomeDir(), "AppData", "Roaming"), "opencode", "opencode.json") : fs.joinPath(fs.getHomeDir(), ".config", "opencode", "opencode.json"),
+    configPath: fs.joinPath(getOpenCodeConfigDir(fs), "opencode.json"),
     serversKey: "mcp",
     serverName: GITHITS_SERVER_NAME,
     serverConfig: {
@@ -5310,6 +5368,26 @@ async function scanAgents(definitions, fs, execService) {
           break;
         }
       }
+    } else if (agent.detectionMethod === "hybrid") {
+      let binaryDetected = false;
+      let pathDetected = false;
+      if (agent.detectBinary) {
+        try {
+          binaryDetected = await agent.detectBinary(execService);
+        } catch {
+          binaryDetected = false;
+        }
+      }
+      if (!binaryDetected && agent.detectPaths) {
+        const paths = agent.detectPaths(fs);
+        for (const path of paths) {
+          if (await fs.isDirectory(path)) {
+            pathDetected = true;
+            break;
+          }
+        }
+      }
+      detected = binaryDetected || pathDetected;
     }
     if (!detected) {
       result.notDetected.push(agent);
@@ -5880,7 +5958,7 @@ function createFeedbackTool(service) {
 import { z as z2 } from "zod";
 var schema2 = {
   query: z2.string().min(1).describe("Natural-language example-search query for canonical code examples."),
-  language: z2.string().min(1).describe("Programming language. Use search_language first if the exact name is uncertain."),
+  language: z2.string().min(1).optional().describe("Optional programming language. If omitted, GitHits tries to infer it automatically. Use search_language first only when you need to force a specific language and the exact name is uncertain."),
   license_mode: z2.enum(["strict", "yolo", "custom"]).optional().describe("License filtering mode: strict (default), yolo, or custom.")
 };
 var DESCRIPTION2 = `Get verified, canonical code examples from global open source.
@@ -5970,10 +6048,6 @@ function invalidTargetResult(message) {
 }
 
 // src/tools/grep-repo.ts
-var pathSelectorSchema = z4.object({
-  kind: z4.enum(["exact", "prefix", "glob"]),
-  value: z4.string()
-});
 var schema3 = {
   target: codeTargetSchema,
   pattern: z4.string().describe(GREP_REPO_PATTERN_NOTE),
@@ -6873,7 +6947,7 @@ function createSearchStatusTool(service) {
 // src/commands/mcp-instructions.ts
 var CORE_BLOCK = `GitHits surfaces verified, canonical code examples from global open source. Use it when you're stuck, the user is frustrated by repeated failed attempts, you need up-to-date API usage, or the user mentions GitHits.
 
-Workflow: call \`search_language\` first if the language name is uncertain → call \`get_example\` with one focused question → send \`feedback\` on the returned solution_id so quality improves. Each search addresses a single issue; reuse context from prior results before re-searching.`;
+Workflow: call \`get_example\` with one focused question, optionally passing \`language\` when the desired language is known; call \`search_language\` first only if you need to force a language and the exact name is uncertain. Send \`feedback\` on the returned solution_id so quality improves. Each search addresses a single issue; reuse context from prior results before re-searching.`;
 var PACKAGE_TOOLS_PREAMBLE = `Package tools work with third-party dependency source plus registry metadata. Use them when a stack trace points into a dependency, you need to verify how a library actually works, or you're evaluating whether to add or upgrade a package.
 
 Package spec: \`registry:name[@version]\`.`;
@@ -6936,28 +7010,34 @@ function buildMcpInstructions(deps) {
 // src/commands/mcp.ts
 function getMcpToolDefinitions(deps) {
   const tools = [
-    createGetExampleTool(deps.githitsService),
-    createSearchLanguageTool(deps.githitsService),
-    createFeedbackTool(deps.githitsService)
+    eraseTool(createGetExampleTool(deps.githitsService)),
+    eraseTool(createSearchLanguageTool(deps.githitsService)),
+    eraseTool(createFeedbackTool(deps.githitsService))
   ];
   const gateOpen = isPackageToolsCapabilityOpen(deps);
   if (gateOpen && deps.codeNavigationService) {
-    tools.push(createSearchTool(deps.codeNavigationService));
-    tools.push(createSearchStatusTool(deps.codeNavigationService));
-    tools.push(createListFilesTool(deps.codeNavigationService));
-    tools.push(createReadFileTool(deps.codeNavigationService));
-    tools.push(createGrepRepoTool(deps.codeNavigationService));
+    tools.push(eraseTool(createSearchTool(deps.codeNavigationService)));
+    tools.push(eraseTool(createSearchStatusTool(deps.codeNavigationService)));
+    tools.push(eraseTool(createListFilesTool(deps.codeNavigationService)));
+    tools.push(eraseTool(createReadFileTool(deps.codeNavigationService)));
+    tools.push(eraseTool(createGrepRepoTool(deps.codeNavigationService)));
   }
   if (gateOpen && deps.packageIntelligenceService) {
-    tools.push(createListPackageDocsTool(deps.packageIntelligenceService));
-    tools.push(createReadPackageDocTool(deps.packageIntelligenceService));
-    tools.push(createPackageSummaryTool(deps.packageIntelligenceService));
-    tools.push(createPackageVulnerabilitiesTool(deps.packageIntelligenceService));
-    tools.push(createPackageDependenciesTool(deps.packageIntelligenceService));
-    tools.push(createPackageChangelogTool(deps.packageIntelligenceService));
+    tools.push(eraseTool(createListPackageDocsTool(deps.packageIntelligenceService)));
+    tools.push(eraseTool(createReadPackageDocTool(deps.packageIntelligenceService)));
+    tools.push(eraseTool(createPackageSummaryTool(deps.packageIntelligenceService)));
+    tools.push(eraseTool(createPackageVulnerabilitiesTool(deps.packageIntelligenceService)));
+    tools.push(eraseTool(createPackageDependenciesTool(deps.packageIntelligenceService)));
+    tools.push(eraseTool(createPackageChangelogTool(deps.packageIntelligenceService)));
   }
   return tools;
 }
+function eraseTool(tool) {
+  return {
+    ...tool,
+    handler: (args, extra) => tool.handler(args, extra)
+  };
+}
 function createMcpServer(deps) {
   const server = new McpServer({
     name: "githits",
@@ -7571,11 +7651,11 @@ function requireSearchService(deps) {
   return deps.codeNavigationService;
 }
 async function loadContainer2() {
-  const { createContainer: createContainer2 } = await import("./shared/chunk-67qnnqby.js");
+  const { createContainer: createContainer2 } = await import("./shared/chunk-4drb8s8v.js");
   return createContainer2();
 }
 async function loadStartupCodeNavigationRegistrationState() {
-  const { resolveStartupCodeNavigationRegistrationState: resolveStartupCodeNavigationRegistrationState2 } = await import("./shared/chunk-67qnnqby.js");
+  const { resolveStartupCodeNavigationRegistrationState: resolveStartupCodeNavigationRegistrationState2 } = await import("./shared/chunk-4drb8s8v.js");
   return resolveStartupCodeNavigationRegistrationState2();
 }
 function parseTargetSpecs(specs) {
@@ -7929,7 +8009,7 @@ Getting started:
   githits init                         Set up MCP for your coding agents
   githits login                        Authenticate with your GitHits account
   githits mcp                          Show MCP setup instructions
-  githits example "query" -l python    Get code examples
+  githits example "query"              Get code examples
 
 Learn more at https://githits.com
 Docs: https://app.githits.com/docs/
@@ -7943,7 +8023,6 @@ registerLanguagesCommand(program);
 registerFeedbackCommand(program);
 var argv = process.argv.slice(2);
 var registrationArgv = stripRootRegistrationOptions(argv);
-var helpInvocation = isHelpInvocation(registrationArgv);
 var shouldLoadGatedHelpRegistration = needsGatedHelpRegistration(registrationArgv);
 var helpRegistrationOptions = shouldLoadGatedHelpRegistration ? await loadHelpRegistrationOptions(registrationArgv) : undefined;
 if (shouldEagerLoadSearchCommands(registrationArgv)) {
@@ -7989,7 +8068,7 @@ function isSearchHelpTarget(value) {
   return value === "search" || value === "search-status";
 }
 async function loadHelpRegistrationOptions(args) {
-  const { resolveStartupCodeNavigationRegistrationState: resolveStartupCodeNavigationRegistrationState2 } = await import("./shared/chunk-67qnnqby.js");
+  const { resolveStartupCodeNavigationRegistrationState: resolveStartupCodeNavigationRegistrationState2 } = await import("./shared/chunk-4drb8s8v.js");
   const registrationState = await resolveStartupCodeNavigationRegistrationState2();
   return {
     capability: registrationState.capability,

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   version
-} from "./shared/chunk-szjytcvw.js";
+} from "./shared/chunk-g6ay6x9v.js";
 export {
   version
 };

package/dist/shared/{chunk-67qnnqby.js → chunk-4drb8s8v.js}

@@ -2,8 +2,8 @@ import {
   createContainer,
   resolveStartupCodeNavigationCapability,
   resolveStartupCodeNavigationRegistrationState
-} from "./chunk-ykr7x8jp.js";
-import"./chunk-szjytcvw.js";
+} from "./chunk-ns1j9dan.js";
+import"./chunk-g6ay6x9v.js";
 export {
   resolveStartupCodeNavigationRegistrationState,
   resolveStartupCodeNavigationCapability,

package/dist/shared/{chunk-szjytcvw.js → chunk-g6ay6x9v.js}

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // package.json
-var version = "0.2.1";
+var version = "0.2.2";
 
 export { __require, version };

package/dist/shared/{chunk-ykr7x8jp.js → chunk-ns1j9dan.js}

@@ -1,6 +1,6 @@
 import {
   version
-} from "./chunk-szjytcvw.js";
+} from "./chunk-g6ay6x9v.js";
 
 // src/services/auth-service.ts
 import { createServer } from "node:http";

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Code examples from global open source for developers and AI assistants.",
   "mcpServers": {
     "githits": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "githits",
   "description": "CLI companion for GitHits - code examples from global open source for developers and AI assistants",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "files": [
     "dist",
@@ -72,6 +72,7 @@
     "@modelcontextprotocol/sdk": "^1.23.0",
     "@napi-rs/keyring": "^1.2.0",
     "commander": "^14.0.2",
+    "jsonc-parser": "^3.3.1",
     "open": "^11.0.0",
     "zod": "^4.1.13"
   },

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Code examples from global open source for developers and AI assistants",
   "author": {
     "name": "GitHits"

package/plugins/claude/commands/example.md

@@ -6,16 +6,17 @@ description: Search for canonical code examples from open source via GitHits
 
 Search for code examples using GitHits for the query: "$ARGUMENTS"
 
-Use the GitHits MCP `get_example` tool with the user's query. The tool requires two
-parameters:
+Use the GitHits MCP `get_example` tool with the user's query.
+
+Required parameter:
 
 - **query**: The user's search query, formulated in natural language.
-- **language**: The programming language. If the language is unclear from
-  context, use the `search_language` tool first to find the correct language
-  name.
 
-Optional parameter:
+Optional parameters:
 
+- **language**: The programming language. Omit it to let GitHits infer the
+  language from the query. If you need to force a specific language and the
+  exact name is uncertain, use the `search_language` tool first.
 - **license_mode**: `"strict"` (default, excludes copyleft), `"yolo"` (all
   licenses), or `"custom"` (user's blocklist).
 

package/plugins/claude/commands/help.md

@@ -28,9 +28,9 @@ context summary:
 This plugin connects to the GitHits MCP server and always exposes three core tools:
 
 - **get_example** — Find code examples by describing what you need in natural
-  language. Requires `query` and `language` parameters.
-- **search_language** — Look up supported programming language names before
-  searching.
+  language. Requires `query`; `language` is optional and inferred when omitted.
+- **search_language** — Look up supported programming language names when you
+  need to force a specific language.
 - **feedback** — Rate a search result to improve future quality.
 
 Additional indexed dependency/package tools such as `search`, `package_summary`,

package/plugins/claude/commands/search.md

@@ -8,16 +8,17 @@ Use GitHits example search for the query: "$ARGUMENTS"
 
 This slash command is the older alias for `/githits:example`.
 
-Use the GitHits MCP `get_example` tool with the user's query. The tool requires two
-parameters:
+Use the GitHits MCP `get_example` tool with the user's query.
+
+Required parameter:
 
 - **query**: The user's search query, formulated in natural language.
-- **language**: The programming language. If the language is unclear from
-  context, use the `search_language` tool first to find the correct language
-  name.
 
-Optional parameter:
+Optional parameters:
 
+- **language**: The programming language. Omit it to let GitHits infer the
+  language from the query. If you need to force a specific language and the
+  exact name is uncertain, use the `search_language` tool first.
 - **license_mode**: `"strict"` (default, excludes copyleft), `"yolo"` (all
   licenses), or `"custom"` (user's blocklist).
 

package/plugins/claude/skills/search/SKILL.md

@@ -28,7 +28,8 @@ Authentication:
 Guidelines:
 
 - Prefer existing search context if it already answers the problem.
-- Use `search_language` first when language naming is uncertain.
+- Pass `language` only when you need to force a specific language; use
+  `search_language` first if the exact language name is uncertain.
 - Use `get_example` for one focused example-search question at a time.
 - When the task is about indexed dependency or repository internals and the
   capability-gated tools are available, prefer unified `search` instead of

package/skills/search/SKILL.md

@@ -28,7 +28,8 @@ Authentication:
 Guidelines:
 
 - Prefer existing search context if it already answers the problem.
-- Use `search_language` first when language naming is uncertain.
+- Pass `language` only when you need to force a specific language; use
+  `search_language` first if the exact language name is uncertain.
 - Use `get_example` for one focused example-search question at a time.
 - When the task is about indexed dependency or repository internals and the
   capability-gated tools are available, prefer unified `search` instead of