githits 0.1.11 → 0.2.0

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.1.11",
+  "version": "0.2.0",
   "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.1.11",
+  "version": "0.2.0",
   "description": "Code examples from global open source for developers and AI assistants",
   "author": {
     "name": "GitHits"

package/GEMINI.md

@@ -4,7 +4,7 @@ Code examples from global open source for developers and AI assistants.
 
 ## Available Tools
 
-### search
+### get_example
 
 Find code examples from open source repositories.
 
@@ -16,7 +16,7 @@ Find code examples from open source repositories.
 
 ### search_language
 
-Look up supported programming language names. Use this before calling `search` to get the correct language identifier.
+Look up supported programming language names. Use this before calling `get_example` to get the correct language identifier.
 
 **Parameters:**
 
@@ -34,14 +34,14 @@ Rate a search result. Submit feedback after each search to improve future result
 
 ## When to Use
 
-Use `search` when:
+Use `get_example` when:
 
 - You are stuck or blocked on an implementation problem
 - You need up-to-date examples for an API, library, or framework
 - The user mentions GitHits or asks you to search for code examples
 - You encounter an error you cannot resolve from your training data
 
-Do not use `search` for:
+Do not use `get_example` for:
 
 - General knowledge questions that do not require code examples
 - Problems you can already solve confidently
@@ -60,12 +60,20 @@ Do not use `search` for:
 
 ## How to Search Well
 
-- Call `search_language` first to confirm the correct language name before calling `search`
+- Call `search_language` first to confirm the correct language name before calling `get_example`
 - 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
 - Submit `feedback` after every search result you use or discard
 
+## Feature-Gated Tools
+
+When the authenticated token carries the `code_navigation` feature flag, GitHits
+also exposes indexed dependency/package tools such as `search`,
+`search_status`, `package_summary`, `package_vulnerabilities`,
+`package_dependencies`, `package_changelog`, `list_files`, `read_file`, and
+`grep_repo`.
+
 ## License Filtering
 
 Results respect license filtering by default. Three modes:

package/README.md

@@ -82,7 +82,7 @@ For plugin-based hosts, install from npm/GitHub using your agent's plugin workfl
 - **GitHub Copilot**: supports Open Plugin components
 - **Gemini CLI**: supports `gemini-extension.json` and `GEMINI.md`
 
-That's it. Your assistant now has GitHits search tools, and on accounts with package/source access enabled it also gets dependency inspection tools.
+That's it. Your assistant now has GitHits example-search tools, and on accounts with package/source access enabled it also gets indexed dependency/package inspection tools.
 
 ## How It Works
 
@@ -92,7 +92,7 @@ Core tools available in every authenticated session:
 
 | Tool | Purpose |
 |---|---|
-| `search` | Find code examples by describing what you need in natural language |
+| `get_example` | Find canonical code examples by describing what you need in natural language |
 | `search_language` | Look up supported programming language names |
 | `feedback` | Rate search results to improve future quality |
 
@@ -102,16 +102,17 @@ When package/source access is enabled for the current token, GitHits also expose
 
 | Tool | Purpose |
 |---|---|
+| `search` | Unified indexed search across dependency/repository code, docs, and symbols |
+| `search_status` | Follow up a prior indexed `search` by `searchRef` |
 | `package_summary` | Quick package overview: version, license, downloads, quickstart, advisories |
 | `package_vulnerabilities` | CVE / OSV advisories for a package or specific version |
 | `package_dependencies` | Direct dependencies, dependency groups, and optional transitive graph |
 | `package_changelog` | Release notes / changelog entries for a package or GitHub repo |
-| `search_symbols` | Exact-token search inside indexed dependency source |
 | `list_files` | Discover what files a dependency or repo contains |
 | `read_file` | Read a dependency file by path |
-| `grep_file` | Search for a case-insensitive substring within one file |
+| `grep_repo` | Deterministic text grep across indexed dependency or repo files |
 
-These advanced tools remain feature-gated. The MCP server advertises them only when the authenticated token is entitled to package/source access.
+These advanced tools remain feature-gated. The MCP server advertises them only when the authenticated token explicitly carries the `code_navigation` feature flag.
 
 ### License Filtering
 
@@ -156,11 +157,16 @@ githits logout         Remove stored credentials
 githits mcp            Show setup instructions in a terminal; starts MCP server when piped
 githits mcp start      Always start MCP server (for use in MCP config files)
 githits auth status    Show current authentication status
+githits example        Get canonical code examples from global open source
+githits languages      List or filter supported language names
+githits feedback       Send feedback on a returned example
 ```
 
-When package/source access is enabled for the current token, two extra command groups are also available:
+When the current token explicitly carries `code_navigation`, these extra commands are also available:
 
 ```
+githits search ...     Unified indexed dependency/repository search
+githits search-status  Follow up a prior indexed search
 githits pkg ...        Package metadata: overview, advisories, deps, changelog
 githits code ...       Dependency source inspection: search, files, read, grep
 ```
@@ -173,14 +179,14 @@ githits code ...       Dependency source inspection: search, files, read, grep
 | `GITHITS_MCP_URL` | Override MCP server URL | `https://mcp.githits.com` |
 | `GITHITS_API_URL` | Override REST API URL | `https://api.githits.com` |
 | `GITHITS_CODE_NAV_URL` | Override package/source service URL | environment-specific |
-| `GITHITS_CODE_NAVIGATION` | Expose hidden `pkg` / `code` command groups locally | — |
+| `GITHITS_CODE_NAVIGATION` | Expose hidden `search` / `pkg` / `code` CLI surfaces locally for development | — |
 | `GITHITS_TELEMETRY` | Emit end-of-run timing spans to stderr for local profiling | — |
 
 ## Manual Setup
 
 If your tool is not in the supported `githits init` list, configure GitHits manually.
 
-The same MCP server command exposes both the core search tools and, when your token is entitled, the package/source inspection tools. No separate install is required.
+The same MCP server command exposes both the core example-search tools and, when your token carries `code_navigation`, the indexed package/source inspection tools. No separate install is required.
 
 Use this MCP server command in your tool's MCP config (the host/agent runs this command):
 

package/commands/example.md

@@ -0,0 +1,23 @@
+---
+description: Search for canonical code examples from open source via GitHits
+---
+
+# Example
+
+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:
+
+- **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:
+
+- **license_mode**: `"strict"` (default, excludes copyleft), `"yolo"` (all
+  licenses), or `"custom"` (user's blocklist).
+
+Present the results clearly. After the user has reviewed the result, use the
+`feedback` tool to report whether the example was helpful.

package/commands/help.md

@@ -16,7 +16,8 @@ context summary:
 
 ## Slash Commands
 
-- `/githits:search <query>` — Search for code examples from open source.
+- `/githits:example <query>` — Search for canonical code examples from open source.
+- `/githits:search <query>` — Legacy alias for `/githits:example`.
 - `/githits:login` — Authenticate with your GitHits account.
 - `/githits:status` — Show your current authentication status.
 - `/githits:logout` — Remove stored credentials.
@@ -24,14 +25,18 @@ context summary:
 
 ## MCP Tools
 
-This plugin connects to the GitHits MCP server and exposes three tools:
+This plugin connects to the GitHits MCP server and always exposes three core tools:
 
-- **search** — Find code examples by describing what you need in natural
+- **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.
 - **feedback** — Rate a search result to improve future quality.
 
+Additional indexed dependency/package tools such as `search`, `package_summary`,
+`list_files`, and `grep_repo` stay hidden unless the authenticated token carries
+the `code_navigation` feature flag.
+
 ## Authentication
 
 Run `npx -y githits login` to authenticate via browser, or set the

package/commands/search.md

@@ -1,12 +1,14 @@
 ---
-description: Search for code examples from open source via GitHits
+description: Legacy alias for GitHits example search
 ---
 
-# Search
+# Search (Legacy Alias)
 
-Search for code examples using GitHits for the query: "$ARGUMENTS"
+Use GitHits example search for the query: "$ARGUMENTS"
 
-Use the GitHits MCP `search` tool with the user's query. The tool requires two
+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:
 
 - **query**: The user's search query, formulated in natural language.