Skip to content

Find code by asking what it does. A CLI for coding agents that uses Jev to discover relevant files and source context.

docs: clarify absolute XDG overrides

David Zhangee50c15a0181
diff --git a/apps/cli/README.md b/apps/cli/README.md
index db73144..d6e479b 100644
--- a/apps/cli/README.md
+++ b/apps/cli/README.md
@@ -69,7 +69,8 @@ These answers need neither `probabilities` nor `confidence`. A server that deman
Credentials are saved under
`$XDG_CONFIG_HOME/jevgrep/credentials.json`, or `~/.config/jevgrep/credentials.json`.
On Windows, config defaults to `%APPDATA%\jevgrep` and cache to `%LOCALAPPDATA%\jevgrep`.
-`XDG_CONFIG_HOME` and `XDG_CACHE_HOME` override their respective locations independently.
+`XDG_CONFIG_HOME` and `XDG_CACHE_HOME` override their respective locations independently
+when set to absolute paths; relative values are ignored and platform defaults are used.
Windows ignores POSIX file modes, so these files rely on the user profile's access controls.
Existing saved records without a provider still mean Vercel, without a migration.
API-key, endpoint, and model environment overrides are ignored; users who only
diff --git a/specs/done/jevgrep/contracts.md b/specs/done/jevgrep/contracts.md
index e7b25ef..03ee39f 100644
--- a/specs/done/jevgrep/contracts.md
+++ b/specs/done/jevgrep/contracts.md
@@ -195,7 +195,9 @@ Malformed/missing answers remain unknown. Healthy negative evaluations may be
cached; failed or incomplete answers may not. Partial provider failures preserve
other useful evidence and are summarized by kind/count, not negative-path lists.
-Default cache directory: `$XDG_CACHE_HOME/jevgrep`, else `~/.cache/jevgrep`.
+XDG config and cache overrides are honored only when their values are absolute;
+relative values are ignored. Default cache directory: `$XDG_CACHE_HOME/jevgrep`,
+else `~/.cache/jevgrep`.
Keep source and credentials out of cache payloads: store content-derived keys and
validated answers, not full source packets. Hash the exact native semantic request
including query, source, path/context, ordered questions, model/provider identity,