githits 0.1.11 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.1.11",
3
+ "version": "0.2.1",
4
4
  "description": "Code examples from global open source for developers and AI assistants.",
5
5
  "mcpServers": {
6
6
  "githits": {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "githits",
3
3
  "description": "CLI companion for GitHits - code examples from global open source for developers and AI assistants",
4
- "version": "0.1.11",
4
+ "version": "0.2.1",
5
5
  "type": "module",
6
6
  "files": [
7
7
  "dist",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.1.11",
3
+ "version": "0.2.1",
4
4
  "description": "Code examples from global open source for developers and AI assistants",
5
5
  "author": {
6
6
  "name": "GitHits"
@@ -0,0 +1,23 @@
1
+ ---
2
+ description: Search for canonical code examples from open source via GitHits
3
+ ---
4
+
5
+ # Example
6
+
7
+ Search for code examples using GitHits for the query: "$ARGUMENTS"
8
+
9
+ Use the GitHits MCP `get_example` tool with the user's query. The tool requires two
10
+ parameters:
11
+
12
+ - **query**: The user's search query, formulated in natural language.
13
+ - **language**: The programming language. If the language is unclear from
14
+ context, use the `search_language` tool first to find the correct language
15
+ name.
16
+
17
+ Optional parameter:
18
+
19
+ - **license_mode**: `"strict"` (default, excludes copyleft), `"yolo"` (all
20
+ licenses), or `"custom"` (user's blocklist).
21
+
22
+ Present the results clearly. After the user has reviewed the result, use the
23
+ `feedback` tool to report whether the example was helpful.
@@ -16,7 +16,8 @@ context summary:
16
16
 
17
17
  ## Slash Commands
18
18
 
19
- - `/githits:search <query>` — Search for code examples from open source.
19
+ - `/githits:example <query>` — Search for canonical code examples from open source.
20
+ - `/githits:search <query>` — Legacy alias for `/githits:example`.
20
21
  - `/githits:login` — Authenticate with your GitHits account.
21
22
  - `/githits:status` — Show your current authentication status.
22
23
  - `/githits:logout` — Remove stored credentials.
@@ -24,14 +25,18 @@ context summary:
24
25
 
25
26
  ## MCP Tools
26
27
 
27
- This plugin connects to the GitHits MCP server and exposes three tools:
28
+ This plugin connects to the GitHits MCP server and always exposes three core tools:
28
29
 
29
- - **search** — Find code examples by describing what you need in natural
30
+ - **get_example** — Find code examples by describing what you need in natural
30
31
  language. Requires `query` and `language` parameters.
31
32
  - **search_language** — Look up supported programming language names before
32
33
  searching.
33
34
  - **feedback** — Rate a search result to improve future quality.
34
35
 
36
+ Additional indexed dependency/package tools such as `search`, `package_summary`,
37
+ `list_files`, and `grep_repo` stay hidden unless the authenticated token carries
38
+ the `code_navigation` feature flag.
39
+
35
40
  ## Authentication
36
41
 
37
42
  Run `npx -y githits login` to authenticate via browser, or set the
@@ -1,12 +1,14 @@
1
1
  ---
2
- description: Search for code examples from open source via GitHits
2
+ description: Legacy alias for GitHits example search
3
3
  ---
4
4
 
5
- # Search
5
+ # Search (Legacy Alias)
6
6
 
7
- Search for code examples using GitHits for the query: "$ARGUMENTS"
7
+ Use GitHits example search for the query: "$ARGUMENTS"
8
8
 
9
- Use the GitHits MCP `search` tool with the user's query. The tool requires two
9
+ This slash command is the older alias for `/githits:example`.
10
+
11
+ Use the GitHits MCP `get_example` tool with the user's query. The tool requires two
10
12
  parameters:
11
13
 
12
14
  - **query**: The user's search query, formulated in natural language.
@@ -29,7 +29,10 @@ Guidelines:
29
29
 
30
30
  - Prefer existing search context if it already answers the problem.
31
31
  - Use `search_language` first when language naming is uncertain.
32
- - Use `search` for one focused question at a time.
32
+ - Use `get_example` for one focused example-search question at a time.
33
+ - When the task is about indexed dependency or repository internals and the
34
+ capability-gated tools are available, prefer unified `search` instead of
35
+ `get_example`.
33
36
  - After using results, send `feedback` with helpful/unhelpful outcome.
34
37
 
35
38
  Tool argument details and rich query guidance are provided directly in the MCP
@@ -29,7 +29,10 @@ Guidelines:
29
29
 
30
30
  - Prefer existing search context if it already answers the problem.
31
31
  - Use `search_language` first when language naming is uncertain.
32
- - Use `search` for one focused question at a time.
32
+ - Use `get_example` for one focused example-search question at a time.
33
+ - When the task is about indexed dependency or repository internals and the
34
+ capability-gated tools are available, prefer unified `search` instead of
35
+ `get_example`.
33
36
  - After using results, send `feedback` with helpful/unhelpful outcome.
34
37
 
35
38
  Tool argument details and rich query guidance are provided directly in the MCP
@@ -1,4 +0,0 @@
1
- // package.json
2
- var version = "0.1.11";
3
-
4
- export { version };