Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.githits.com/llms.txt

Use this file to discover all available pages before exploring further.

The GitHits CLI reads several environment variables at startup. You can use them to authenticate without a browser, switch credential storage modes, point the CLI at a different server, or suppress update notifications.
VariablePurposeDefault
GITHITS_API_TOKENAPI token for authentication (format: ghi-...)—
GITHITS_AUTH_STORAGEOverride OAuth storage mode: keychain or filekeychain
GITHITS_MCP_URLOverride MCP server URLhttps://mcp.githits.com
GITHITS_API_URLOverride REST API URLhttps://api.githits.com
GITHITS_CODE_NAV_URLOverride package/source service URLhttps://pkgseer.dev
GITHITS_TELEMETRYEmit end-of-run timing spans to stderr for local profiling—
GITHITS_DISABLE_UPDATE_CHECKDisable npm latest-version update notices—

​
GITHITS_API_TOKEN

Set an API token to authenticate without browser OAuth. This is the recommended approach for CI pipelines, automation scripts, and headless environments where a browser login isn’t practical. Tokens follow the format ghi-... and can be generated from your GitHits account settings. When GITHITS_API_TOKEN is set, the CLI skips local OAuth storage entirely. You can verify this with npx githits@latest auth status, which reports the credential source. 
export GITHITS_API_TOKEN=ghi-your-token-here
npx githits@latest auth status
GITHITS_API_TOKEN takes precedence over stored OAuth credentials. If both are present, the environment variable is used.

​
GITHITS_AUTH_STORAGE

Override the OAuth credential storage mode for a single process or for all GitHits commands in the current shell session.
  • keychain (default) — stores OAuth credentials in the system keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service).
  • file — stores OAuth credentials as JSON files in the GitHits config directory.
Use file mode in SSH sessions, CI environments, or when persistent keychain prompts remain even after granting access. 
GITHITS_AUTH_STORAGE=file npx githits@latest login --force
File storage is not encrypted. Any process running as your OS user can read the stored tokens. For CI and automation, use GITHITS_API_TOKEN instead.

​
GITHITS_MCP_URL

Override the MCP server URL. By default the CLI connects to https://mcp.githits.com. Set this variable to point at a self-hosted or staging MCP server. 
export GITHITS_MCP_URL=https://mcp.example.com

​
GITHITS_API_URL

Override the REST API base URL. By default the CLI uses https://api.githits.com. 
export GITHITS_API_URL=https://api-staging.example.com

​
GITHITS_CODE_NAV_URL

Override the URL for the package and source navigation service. By default the CLI uses https://pkgseer.dev. 
export GITHITS_CODE_NAV_URL=https://pkgseer-staging.example.com

​
GITHITS_TELEMETRY

When set to any non-empty value, the CLI emits end-of-run timing spans to stderr. Use this for local profiling and performance investigation. The output goes to stderr only and does not affect stdout. 
GITHITS_TELEMETRY=1 npx githits@latest example "connect to redis"

​
GITHITS_DISABLE_UPDATE_CHECK

When set to any non-empty value, suppresses the npm latest-version check and update notice that the CLI prints when a newer version is available. Useful in CI environments where the notice would pollute log output. 
export GITHITS_DISABLE_UPDATE_CHECK=1