githits 0.7.0 → 0.9.0
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.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/plugin.json +1 -1
- package/.plugin/plugin.json +1 -1
- package/README.md +47 -0
- package/dist/cli.js +48 -39
- package/dist/index.js +1 -1
- package/dist/shared/{chunk-ncsgqtj1.js → chunk-g4nejfkv.js} +1 -1
- package/dist/shared/{chunk-p8dg49ey.js → chunk-gstxy5m0.js} +1 -1
- package/dist/shared/{chunk-mysf4hjt.js → chunk-mn03rmdy.js} +11 -11
- package/gemini-extension.json +1 -1
- package/mcp.json +9 -0
- package/package.json +5 -4
- package/plugin.json +25 -1
- package/server.json +2 -2
- package/skills/githits-code/SKILL.md +3 -0
- package/skills/githits-code/references/code-and-docs.md +2 -1
- package/skills/githits-package/SKILL.md +1 -0
package/gemini-extension.json
CHANGED
package/mcp.json
ADDED
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "githits",
|
|
3
3
|
"description": "The code context layer for AI coding agents",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.9.0",
|
|
5
5
|
"mcpName": "com.githits/githits",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"workspaces": [
|
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
".codex-plugin",
|
|
16
16
|
".cursor-plugin",
|
|
17
17
|
".mcp.json",
|
|
18
|
+
"mcp.json",
|
|
18
19
|
"server.json",
|
|
19
20
|
"gemini-extension.json",
|
|
20
21
|
"plugin.json",
|
|
@@ -108,17 +109,17 @@
|
|
|
108
109
|
"open": "^11.0.0",
|
|
109
110
|
"semver": "7.8.5",
|
|
110
111
|
"smol-toml": "^1.6.1",
|
|
111
|
-
"undici": "7.
|
|
112
|
+
"undici": "7.29.0",
|
|
112
113
|
"yaml": "^2.9.0",
|
|
113
114
|
"zod": "^4.4.3"
|
|
114
115
|
},
|
|
115
116
|
"devDependencies": {
|
|
116
|
-
"@biomejs/biome": "2.5.
|
|
117
|
+
"@biomejs/biome": "2.5.6",
|
|
117
118
|
"@types/bun": "latest",
|
|
118
119
|
"@types/semver": "^7.7.1",
|
|
119
120
|
"bunup": "^0.16.32",
|
|
120
121
|
"husky": "^9.1.7",
|
|
121
|
-
"lint-staged": "17.
|
|
122
|
+
"lint-staged": "17.3.0",
|
|
122
123
|
"typescript": "^7.0.2"
|
|
123
124
|
}
|
|
124
125
|
}
|
package/plugin.json
CHANGED
|
@@ -1,3 +1,27 @@
|
|
|
1
1
|
{
|
|
2
|
-
"
|
|
2
|
+
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
|
+
"name": "githits",
|
|
4
|
+
"version": "0.9.0",
|
|
5
|
+
"description": "The code context layer for AI coding agents",
|
|
6
|
+
"author": {
|
|
7
|
+
"name": "GitHits"
|
|
8
|
+
},
|
|
9
|
+
"homepage": "https://githits.com",
|
|
10
|
+
"repository": "https://github.com/githits-com/githits-cli",
|
|
11
|
+
"license": "Apache-2.0",
|
|
12
|
+
"keywords": [
|
|
13
|
+
"githits",
|
|
14
|
+
"context layer",
|
|
15
|
+
"public open-source",
|
|
16
|
+
"open-source code",
|
|
17
|
+
"code search",
|
|
18
|
+
"package documentation",
|
|
19
|
+
"documentation search",
|
|
20
|
+
"package metadata",
|
|
21
|
+
"vulnerabilities",
|
|
22
|
+
"changelogs",
|
|
23
|
+
"dependency graphs",
|
|
24
|
+
"upgrade evidence",
|
|
25
|
+
"implementation examples"
|
|
26
|
+
]
|
|
3
27
|
}
|
package/server.json
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
"source": "github",
|
|
17
17
|
"id": "1165453165"
|
|
18
18
|
},
|
|
19
|
-
"version": "0.
|
|
19
|
+
"version": "0.9.0",
|
|
20
20
|
"remotes": [
|
|
21
21
|
{
|
|
22
22
|
"type": "streamable-http",
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"registryType": "npm",
|
|
29
29
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
30
30
|
"identifier": "githits",
|
|
31
|
-
"version": "0.
|
|
31
|
+
"version": "0.9.0",
|
|
32
32
|
"runtimeHint": "npx",
|
|
33
33
|
"transport": {
|
|
34
34
|
"type": "stdio"
|
|
@@ -16,6 +16,7 @@ Use GitHits for evidence from real open-source code instead of guessing from mod
|
|
|
16
16
|
- If `githits` is not found, retry the same command as `npx -y githits@latest ...`.
|
|
17
17
|
- Use `--json` when you need stable fields to parse or chain into another command.
|
|
18
18
|
- Do not expose credentials. If auth is required interactively, run `githits login`; use `githits login --no-browser` only when the user can complete the printed URL flow. In noninteractive eval/CI, do not start OAuth; report that `GITHITS_API_TOKEN` or prior login is required.
|
|
19
|
+
- If a command returns `TERMS_ACCEPTANCE_REQUIRED`, run `githits settings terms accept` or use the returned authenticated acceptance URL, then retry once.
|
|
19
20
|
|
|
20
21
|
## Decision Flow
|
|
21
22
|
|
|
@@ -58,6 +59,8 @@ githits docs read <pageId> --lines 20-120
|
|
|
58
59
|
- For multi-step code/docs investigations, keep raw CLI output out of the final answer unless it is the evidence the user needs.
|
|
59
60
|
- If output says it used recent/stale indexed evidence, treat the displayed served target as provenance; if freshness matters, retry with a longer `--wait` or use one of the displayed `queryable now` versions/refs, or inspect JSON `targetResolution` for structured candidates.
|
|
60
61
|
- Treat partial documentation coverage as incomplete evidence and retry later when advised. Capped coverage is terminal for the current crawl, so report the limitation instead of retrying.
|
|
62
|
+
- If search returns a `searchRef`, continue with `githits search-status <searchRef>` instead of repeating the original search. Its bounded wait defaults to 20 seconds; use `--wait 0-60` to adjust it.
|
|
63
|
+
- If grep returns no matches, do not repeat it unchanged. Follow the returned guidance by changing the pattern, broadening the file scope, or switching to `githits search` for conceptual discovery.
|
|
61
64
|
- If a code-navigation command returns `INDEXING`, use the elapsed/expected duration in the message to decide whether to retry with `--wait`; prefer any displayed indexed refs/versions when you need an immediate follow-up.
|
|
62
65
|
- After using GitHits results, send feedback when practical. Use `githits feedback <solution_id> --accept|--reject` for `githits example` results, or omit `<solution_id>` for generic session feedback such as `githits feedback --reject --tool search -m "missing kotlin support"`.
|
|
63
66
|
|
|
@@ -8,7 +8,7 @@ Package target syntax requires an explicit registry: `registry:name[@version]`,
|
|
|
8
8
|
|
|
9
9
|
Useful filters: `--kind`, `--category`, `--path-prefix`, `--intent`, `--public`, `--name`, `--lang`, `--limit`, `--offset`, `--wait`, `--allow-partial`, `--json`.
|
|
10
10
|
|
|
11
|
-
If search returns a `searchRef`,
|
|
11
|
+
If search returns a `searchRef`, do not repeat the original search. Continue with `githits search-status <searchRef> [--wait 0-60]`; the bounded wait defaults to 20 seconds.
|
|
12
12
|
|
|
13
13
|
## Code Files
|
|
14
14
|
|
|
@@ -27,6 +27,7 @@ For repository addressing: `githits code read --repo-url <url> [--git-ref <ref>]
|
|
|
27
27
|
`githits code grep <spec> <pattern> [path-prefix]` runs deterministic text grep. Use `--regex` for RE2 regex, `--case-sensitive`, `-C`, `-A`, `-B`, `--path`, repeatable `--glob`, repeatable `--ext`, `--exclude-docs`, `--exclude-tests`, `--limit`, `--per-file-limit`, `--cursor`, `--symbol-field`, `--wait`, `--verbose`, `--json`.
|
|
28
28
|
|
|
29
29
|
Use `search` for discovery and `code grep` only when you know the pattern.
|
|
30
|
+
When grep returns no matches, do not repeat it unchanged. Change or shorten the pattern, broaden the path/filter scope, or switch to `search` for conceptual intent.
|
|
30
31
|
|
|
31
32
|
## Docs
|
|
32
33
|
|
|
@@ -17,6 +17,7 @@ Use GitHits package intelligence before making dependency claims from memory.
|
|
|
17
17
|
- If `githits` is not found, retry the same command as `npx -y githits@latest ...`.
|
|
18
18
|
- Use `--json` when comparing versions, counting vulnerabilities, or extracting fields.
|
|
19
19
|
- Do not expose credentials. If auth is required interactively, run `githits login`; use `githits login --no-browser` only when the user can complete the printed URL flow. In noninteractive eval/CI, do not start OAuth; report that `GITHITS_API_TOKEN` or prior login is required.
|
|
20
|
+
- If a command returns `TERMS_ACCEPTANCE_REQUIRED`, run `githits settings terms accept` or use the returned authenticated acceptance URL, then retry once.
|
|
20
21
|
|
|
21
22
|
## Package Spec
|
|
22
23
|
|