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.

Document local skill lock portability and refresh workflow

andrewceb560a16c05
diff --git a/README.md b/README.md
index 4a563c8..3cc2493 100644
--- a/README.md
+++ b/README.md
@@ -65,7 +65,9 @@ jg --version
```
After updating the CLI, refresh the installed skill by rerunning `jg skill`. Updating the npm package does not
-overwrite skill files in your projects. See the [package guide](apps/cli/README.md)
+overwrite skill files in your projects. The installer records a machine-specific local
+path in `skills-lock.json`; `skills update` skips this entry. Rerun `jg skill` on
+another machine or after changing your Node installation. See the [package guide](apps/cli/README.md)
for authentication details.
## Start with a question, leave with source
diff --git a/apps/cli/README.md b/apps/cli/README.md
index 5ed82a4..38d66e9 100644
--- a/apps/cli/README.md
+++ b/apps/cli/README.md
@@ -70,7 +70,9 @@ others) and asks where to install. `jg skill` also accepts `--agent NAME`
(repeatable), `--global`, and `--yes`; these options come from the
[skills CLI](https://github.com/vercel-labs/skills#install-a-skill), which it
delegates to. Use `jg skill` so the installed instructions match your CLI release;
-it requires Node 22.20+ and npm/npx with network access for the pinned installer.
+it installs the bundled skill with npm lifecycle scripts disabled and requires
+Node 22.20+ and npm/npx with network access for the pinned installer. Installer
+transitive dependencies remain an external trust boundary.
Installing the skill does not configure the provider key. Users of 0.1.0, whose
`jg skill` only prints the skill, should upgrade the CLI first.
@@ -82,12 +84,9 @@ the needed context is already known, and handle incomplete results honestly.
There is no built-in upgrade command. Use `npm install --global @dzhng/jevgrep@latest`
to upgrade the CLI, then rerun `jg skill` to update
-the agent's copy too.
+the agent's copy too. The installer records a machine-specific local path in
+`skills-lock.json`; `skills update` skips this entry. Rerun `jg skill` on another
+machine or after changing your Node installation.
See the [repository](https://github.com/dzhng/jevgrep) for architecture, official
benchmark evidence and development. Jevgrep is MIT licensed.
-
-Skill installation uses a pinned installer and the skill bundled with the CLI,
-with npm lifecycle scripts disabled. It requires Node 22.20+ and network access
-for the installer. After updating the CLI, rerun `jg skill` to refresh the agent's
-copy. Installer transitive dependencies remain an external trust boundary.