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.
@@ -6,12 +6,12 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "The code context layer for AI coding agents",
9
- "version": "0.7.0"
9
+ "version": "0.9.0"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "githits",
14
- "version": "0.7.0",
14
+ "version": "0.9.0",
15
15
  "description": "The code context layer for AI coding agents",
16
16
  "author": {
17
17
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.7.0",
3
+ "version": "0.9.0",
4
4
  "description": "The code context layer for AI coding agents",
5
5
  "author": {
6
6
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.7.0",
3
+ "version": "0.9.0",
4
4
  "description": "The code context layer for AI coding agents",
5
5
  "author": {
6
6
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.7.0",
3
+ "version": "0.9.0",
4
4
  "description": "The code context layer for AI coding agents",
5
5
  "author": {
6
6
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.7.0",
3
+ "version": "0.9.0",
4
4
  "description": "The code context layer for AI coding agents",
5
5
  "author": {
6
6
  "name": "GitHits"
package/README.md CHANGED
@@ -18,6 +18,7 @@
18
18
  <a href="https://skills.sh/githits-com/githits-cli"><img alt="skills.sh" src="https://skills.sh/b/githits-com/githits-cli"></a>
19
19
  <a href="https://smithery.ai/servers/githits/GitHits"><img alt="smithery badge" src="https://smithery.ai/badge/githits/GitHits"></a>
20
20
  <a href="https://glama.ai/mcp/servers/githits-com/githits-cli"><img alt="githits-cli MCP server" src="https://glama.ai/mcp/servers/githits-com/githits-cli/badges/score.svg"></a>
21
+ <a href="https://lobehub.com/mcp/githits-com-githits-cli"><img alt="MCP Badge" src="https://lobehub.com/badge/mcp/githits-com-githits-cli?style=plastic"></a>
21
22
  </p>
22
23
 
23
24
  <p align="center">
@@ -191,6 +192,51 @@ work with `githits login` after setup.
191
192
  Browser OAuth is interactive. For CI and other unattended environments, supply
192
193
  `GITHITS_API_TOKEN` through the environment's secret manager.
193
194
 
195
+ ### Keychain Prompts and File Storage
196
+
197
+ GitHits uses the system keychain by default because OAuth credentials include a
198
+ refresh token. On macOS this means Keychain Access; on Windows it means
199
+ Credential Manager; on Linux it means the available Secret Service or keyring
200
+ backend.
201
+
202
+ If macOS shows a prompt such as "githits wants to access ... in your keychain",
203
+ choose **Always Allow** when you trust the installed `githits` CLI. GitHits
204
+ cannot customize that operating-system prompt; it is generated by macOS.
205
+
206
+ GitHits also writes a small non-secret metadata file so recent startup checks do
207
+ not need to read the keychain. The keychain is only read when GitHits needs the
208
+ token, for example during a tool call, token refresh, `githits auth status`, or a
209
+ login check after metadata is stale or expired.
210
+
211
+ If your agent keeps showing keychain prompts even after **Always Allow**, switch
212
+ OAuth storage to file mode:
213
+
214
+ ```toml
215
+ # macOS/Linux: ~/.config/githits/config.toml, or $XDG_CONFIG_HOME/githits/config.toml
216
+ # Windows: %APPDATA%\githits\config.toml
217
+ [auth]
218
+ storage = "file"
219
+ ```
220
+
221
+ The config directory may be empty until you create `config.toml` or GitHits
222
+ writes auth metadata. Older macOS installs may have used
223
+ `~/Library/Application Support/githits`; GitHits still reads that location for
224
+ migration, but new auth config and file storage use `~/.config/githits`.
225
+
226
+ You can also opt in for one process:
227
+
228
+ ```sh
229
+ GITHITS_AUTH_STORAGE=file githits login --force
230
+ ```
231
+
232
+ File mode stores OAuth credentials as JSON files under the GitHits config
233
+ directory. The files are written with private permissions where the platform
234
+ supports it, but they are not encrypted. Any process that can read files as your
235
+ operating-system user may be able to read the tokens.
236
+
237
+ Use file mode only on machines where you trust local user-account access. For CI
238
+ and automation, prefer `GITHITS_API_TOKEN` instead of browser OAuth.
239
+
194
240
  Inspect auth and runtime state with:
195
241
 
196
242
  ```sh
@@ -304,6 +350,7 @@ githits example Find real-world implementations from open source
304
350
  githits languages List or filter supported programming languages
305
351
  githits feedback Submit feedback about GitHits results
306
352
  githits doctor Diagnose configuration and auth state
353
+ githits settings View and update preferences, privacy, and terms
307
354
  githits search Explore repository code, dependencies, docs, and symbols
308
355
  githits search-status Check the status of a previous indexed search
309
356
  githits code List, read, and grep indexed dependency source