Skip to content

Commit eebe53d

Browse files
scgopiclaude
andcommitted
README: fix the Copilot pin install command and tighten the section
npm install -g @github/copilot@v1.0.84-5 does not resolve; no published version carries a v prefix. The next line already used the bare version. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016n4hSXVu6wLR4RCfnt6PPG
1 parent b4fd5dd commit eebe53d

1 file changed

Lines changed: 12 additions & 25 deletions

File tree

README.md

Lines changed: 12 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -80,37 +80,24 @@ Releases are Developer ID signed and notarized.
8080
State lives in `~/.graphcode/` — graphs, recents, layouts, the daemon socket and logs, and the installed
8181
binaries. **Nothing is ever written inside a project folder you open.**
8282

83-
### Use a known-good Copilot version
83+
### Pin a Copilot CLI version
8484

85-
If a Copilot CLI update is broken, first install a known-good published version on each
86-
machine where Copilot runs, including remote hosts, and verify the reported version.
87-
For example:
85+
Copilot loops follow the CLI's own version selection. To hold a specific published version,
86+
install it on every machine that runs Copilot, including remote hosts:
8887

8988
```sh
90-
npm install -g @github/copilot@v1.0.84-5 &&
89+
npm install -g @github/copilot@1.0.84-5
9190
copilot --prefer-version 1.0.84-5 --version
9291
```
9392

94-
Only after installation succeeds and the reported version matches, set
95-
**Settings > Preferred versions > Copilot CLI** to **Specific version** and enter that version.
96-
The section follows **Permissions** and has one row per backend, all starting at **Default**.
97-
Claude Code, Codex, OpenCode, and Pi are locked to **Default** until version overrides are
98-
supported for them. This does not change which backend new loops or Quick Chats use.
99-
The Copilot field accepts any published version; `1.0.84-5` is just an example. GraphCode passes
100-
`--prefer-version <version>` to new and resumed Copilot sessions (app and daemon, local and
101-
SSH), and to Copilot title and summary requests. Running sessions are not interrupted.
102-
103-
Settings provides a copyable install command for the chosen version; GraphCode does not run
104-
it automatically or verify installation before activating the preference. The preference
105-
takes effect immediately for subsequent launches. Keep `copilot` on the login shell's `PATH`.
106-
Without the app, set
107-
`"copilotPreferredVersion": "1.0.84-5"` in `~/.graphcode/settings.json` (or the workspace's
108-
`GRAPHCODE_SUPPORT_DIR/settings.json`), preserving the other keys. The setting is read on
109-
each launch, so no daemon restart is needed.
110-
111-
Choose **Default**, clear the field, or remove the JSON key to stop passing `--prefer-version`.
112-
**Default** follows the CLI's own version selection; it does not install the latest release. If you also
113-
downgraded the global npm installation, run `npm install -g @github/copilot@latest` to update it.
93+
Then set **Settings ▸ Preferred versions ▸ Copilot CLI** to that version. GraphCode passes it to
94+
new and resumed Copilot sessions, locally and over SSH, and to Copilot title and summary
95+
requests; sessions already running are unaffected. Without the app, set
96+
`"copilotPreferredVersion": "1.0.84-5"` in `~/.graphcode/settings.json` — it is read on each
97+
launch, so no daemon restart is needed.
98+
99+
Clear the field to return to the CLI's own selection. GraphCode installs nothing itself, so a
100+
version you have not installed on the host will not be there when a loop launches.
114101

115102
## Workspaces
116103

0 commit comments

Comments
 (0)