@@ -80,37 +80,24 @@ Releases are Developer ID signed and notarized.
8080State lives in ` ~/.graphcode/ ` — graphs, recents, layouts, the daemon socket and logs, and the installed
8181binaries. ** 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
9190copilot --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