codex-overleaf-link 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +37 -43
  2. package/extension/src/shared/compatibility.js +1 -1
  3. package/package.json +9 -1
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  <h1>Codex Overleaf Link</h1>
4
4
  <p><strong>Empower Overleaf with Codex.</strong></p>
5
5
  <p>
6
- <img src="https://img.shields.io/badge/version-1.1.2-blue" alt="version">
6
+ <img src="https://img.shields.io/badge/version-1.1.3-blue" alt="version">
7
7
  <img src="https://img.shields.io/badge/platform-macOS%20%2F%20Windows%20%2F%20Linux-lightgrey" alt="platform">
8
8
  <img src="https://img.shields.io/badge/chrome-MV3-green" alt="chrome manifest v3">
9
9
  <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="node version">
@@ -29,43 +29,36 @@ Codex Overleaf Link bridges the two: it adds a Codex panel directly inside Overl
29
29
 
30
30
  ## Install
31
31
 
32
- The official release path is still a one-command native-host install plus Chrome's required manual approval for an unpacked extension. The bundled extension key gives the official unpacked build a stable id, so you do not need to pass an extension id for normal release installs.
32
+ The recommended release path is npm-first for the native host, plus Chrome's required manual approval for the unpacked extension. The bundled extension key gives the official unpacked build a stable id, so normal release installs do not need `--extension-id`.
33
33
 
34
- macOS / Linux latest source install:
34
+ 1. Install or update the native host with the pinned npm package:
35
35
 
36
36
  ```bash
37
- curl -fsSL "https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/main/install.sh?$(date +%s)" | bash
37
+ npm exec --yes codex-overleaf-link@1.1.3 -- install-native
38
38
  ```
39
39
 
40
- Recommended version-pinned native-host install or update for v1.1.2:
40
+ 2. Download `codex-overleaf-link-extension-v1.1.3.zip` from the [v1.1.3 GitHub Release](https://github.com/Ghqqqq/codex-overleaf-link/releases/tag/v1.1.3), then unzip it to a stable local folder.
41
41
 
42
- ```bash
43
- npm exec --yes codex-overleaf-link@1.1.2 -- install-native
44
- ```
42
+ 3. Open `chrome://extensions`, enable **Developer mode**, click **Load unpacked**, and select the unzipped extension folder.
43
+
44
+ 4. Open any Overleaf project. The Codex panel appears on the right.
45
+
46
+ If you modify the extension key or load a custom build that gets a different id, rerun the native install with `--extension-id <chrome-extension-id>`.
45
47
 
46
- GitHub Release script fallback for macOS / Linux:
48
+ Source installer fallback for macOS / Linux, mainly for development or source checkout installs:
47
49
 
48
50
  ```bash
49
- CODEX_OVERLEAF_REF=v1.1.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.2/install.sh)"
51
+ CODEX_OVERLEAF_REF=v1.1.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.3/install.sh)"
50
52
  ```
51
53
 
52
- GitHub Release script fallback for Windows from PowerShell:
54
+ Source installer fallback for Windows from PowerShell:
53
55
 
54
56
  ```powershell
55
- iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.2/install.ps1 -OutFile install.ps1
56
- $env:CODEX_OVERLEAF_REF='v1.1.2'
57
+ iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.3/install.ps1 -OutFile install.ps1
58
+ $env:CODEX_OVERLEAF_REF='v1.1.3'
57
59
  powershell -ExecutionPolicy Bypass -File install.ps1
58
60
  ```
59
61
 
60
- The macOS / Linux installer creates a visible `~/Codex Overleaf Link Extension` shortcut to the extension folder. On macOS it also opens Chrome's extension page, opens Finder to the shortcut, and copies the shortcut path. The Windows installer prints the extension folder path after registering the native host.
61
-
62
- Chrome still requires one manual approval step for unpacked extensions:
63
-
64
- 1. Enable **Developer mode** in `chrome://extensions`.
65
- 2. Click **Load unpacked** and select `~/Codex Overleaf Link Extension` on macOS/Linux, or the printed extension folder on Windows.
66
-
67
- If you modify the extension key or load a custom build that gets a different id, rerun the native install with `--extension-id <chrome-extension-id>`.
68
-
69
62
  ## npm Native Host CLI
70
63
 
71
64
  npm installs, updates, uninstalls, and diagnoses the native host only. npm does not install the Chrome extension; install the Chrome extension separately from the release source checkout or extension zip.
@@ -73,19 +66,19 @@ npm installs, updates, uninstalls, and diagnoses the native host only. npm does
73
66
  Install or update the native host for the official release extension id:
74
67
 
75
68
  ```bash
76
- npm exec --yes codex-overleaf-link@1.1.2 -- install-native
69
+ npm exec --yes codex-overleaf-link@1.1.3 -- install-native
77
70
  ```
78
71
 
79
72
  Diagnose the registered native host:
80
73
 
81
74
  ```bash
82
- npm exec --yes codex-overleaf-link@1.1.2 -- doctor
75
+ npm exec --yes codex-overleaf-link@1.1.3 -- doctor
83
76
  ```
84
77
 
85
78
  Uninstall the native host:
86
79
 
87
80
  ```bash
88
- npm exec --yes codex-overleaf-link@1.1.2 -- uninstall-native
81
+ npm exec --yes codex-overleaf-link@1.1.3 -- uninstall-native
89
82
  ```
90
83
 
91
84
  Use `--extension-id <chrome-extension-id>` only for a custom/dev unpacked extension id that differs from the official bundled id.
@@ -123,10 +116,10 @@ If Chrome assigns a different extension id, rerun `npm run install:native -- --e
123
116
  <details>
124
117
  <summary><strong>Update</strong></summary>
125
118
 
126
- For a deterministic v1.1.2 update, run the pinned npm command. This is also the native mismatch recovery command shown by the popup and panel when they report **Native host update required**.
119
+ For a deterministic v1.1.3 update, run the pinned npm command. This is also the native mismatch recovery command shown by the popup and panel when they report **Native host update required**.
127
120
 
128
121
  ```bash
129
- npm exec --yes codex-overleaf-link@1.1.2 -- install-native
122
+ npm exec --yes codex-overleaf-link@1.1.3 -- install-native
130
123
  ```
131
124
 
132
125
  If npm is unavailable, use the GitHub Release script fallback for your platform.
@@ -134,14 +127,14 @@ If npm is unavailable, use the GitHub Release script fallback for your platform.
134
127
  macOS / Linux:
135
128
 
136
129
  ```bash
137
- CODEX_OVERLEAF_REF=v1.1.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.2/install.sh)"
130
+ CODEX_OVERLEAF_REF=v1.1.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.3/install.sh)"
138
131
  ```
139
132
 
140
133
  Windows PowerShell:
141
134
 
142
135
  ```powershell
143
- iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.2/install.ps1 -OutFile install.ps1
144
- $env:CODEX_OVERLEAF_REF='v1.1.2'
136
+ iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.3/install.ps1 -OutFile install.ps1
137
+ $env:CODEX_OVERLEAF_REF='v1.1.3'
145
138
  powershell -ExecutionPolicy Bypass -File install.ps1
146
139
  ```
147
140
 
@@ -151,14 +144,15 @@ Then reload the extension in `chrome://extensions` and refresh the Overleaf page
151
144
 
152
145
  ## GitHub Release Artifacts
153
146
 
154
- The v1.1.2 GitHub Release contains:
147
+ The v1.1.3 GitHub Release contains:
155
148
 
156
- - `codex-overleaf-link-extension-v1.1.2.zip`: loadable Chrome extension package for manual unpacked installation.
157
- - `codex-overleaf-native-host-v1.1.2.tar.gz`: native host runtime files used by the installer and release verification.
158
- - `codex-overleaf-link-1.1.2.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
159
- - `install.sh`: release-pinned macOS / Linux installer that defaults to `v1.1.2` when run directly from the release artifact.
160
- - `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.1.2` when run directly from the release artifact.
149
+ - `codex-overleaf-link-extension-v1.1.3.zip`: loadable Chrome extension package for manual unpacked installation.
150
+ - `codex-overleaf-native-host-v1.1.3.tar.gz`: native host runtime files used by the installer and release verification.
151
+ - `codex-overleaf-link-1.1.3.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
152
+ - `install.sh`: release-pinned macOS / Linux installer that defaults to `v1.1.3` when run directly from the release artifact.
153
+ - `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.1.3` when run directly from the release artifact.
161
154
  - `uninstall-native-host.mjs`: native host uninstaller that removes the Chrome Native Messaging manifest, bridge executable, and runtime copy.
155
+ - `nativeHostPlatform.js`, `manifest.js`, `runtimeInstaller.js`: helper files required by the loose uninstaller asset.
162
156
  - `SHA256SUMS` and `release-manifest.json`: checksum and artifact metadata for release verification.
163
157
 
164
158
  <details>
@@ -208,7 +202,7 @@ The uninstaller removes the Native Messaging registration, bridge executable, an
208
202
  Linux Chromium install or update:
209
203
 
210
204
  ```bash
211
- CODEX_OVERLEAF_REF=v1.1.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.2/install.sh)" -- --browser chromium
205
+ CODEX_OVERLEAF_REF=v1.1.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.3/install.sh)" -- --browser chromium
212
206
  ```
213
207
 
214
208
  Linux Chromium uninstall:
@@ -350,7 +344,7 @@ Composer attachments are turn-scoped Codex context. Limits are 8 attachments per
350
344
  Run the pinned npm native-host installer, reload the extension in `chrome://extensions`, then refresh the Overleaf tab. This also fixes extension/native version mismatch and native protocol mismatch.
351
345
 
352
346
  ```bash
353
- npm exec --yes codex-overleaf-link@1.1.2 -- install-native
347
+ npm exec --yes codex-overleaf-link@1.1.3 -- install-native
354
348
  ```
355
349
 
356
350
  If npm is unavailable, use the GitHub Release script fallback for your platform.
@@ -358,14 +352,14 @@ If npm is unavailable, use the GitHub Release script fallback for your platform.
358
352
  macOS/Linux:
359
353
 
360
354
  ```bash
361
- CODEX_OVERLEAF_REF=v1.1.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.2/install.sh)"
355
+ CODEX_OVERLEAF_REF=v1.1.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.3/install.sh)"
362
356
  ```
363
357
 
364
358
  Windows PowerShell:
365
359
 
366
360
  ```powershell
367
- iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.2/install.ps1 -OutFile install.ps1
368
- $env:CODEX_OVERLEAF_REF='v1.1.2'
361
+ iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.1.3/install.ps1 -OutFile install.ps1
362
+ $env:CODEX_OVERLEAF_REF='v1.1.3'
369
363
  powershell -ExecutionPolicy Bypass -File install.ps1
370
364
  ```
371
365
 
@@ -424,8 +418,8 @@ Use this matrix for release-candidate signoff and compatibility reports. Record
424
418
  | Browser/channel/version | Google Chrome channel and version. | Google Chrome channel and version. | Google Chrome channel and version. | Chromium channel/package and version. |
425
419
  | Install mode | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout; native host installed with `--browser chromium`. |
426
420
  | Extension id | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. |
427
- | Installer/update command | `npm exec --yes codex-overleaf-link@1.1.2 -- install-native` | `npm exec --yes codex-overleaf-link@1.1.2 -- install-native` | `npm exec --yes codex-overleaf-link@1.1.2 -- install-native` | `npm exec --yes codex-overleaf-link@1.1.2 -- install-native --browser chromium` |
428
- | Uninstall command | `npm exec --yes codex-overleaf-link@1.1.2 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.1.2 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.1.2 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.1.2 -- uninstall-native --browser chromium` |
421
+ | Installer/update command | `npm exec --yes codex-overleaf-link@1.1.3 -- install-native` | `npm exec --yes codex-overleaf-link@1.1.3 -- install-native` | `npm exec --yes codex-overleaf-link@1.1.3 -- install-native` | `npm exec --yes codex-overleaf-link@1.1.3 -- install-native --browser chromium` |
422
+ | Uninstall command | `npm exec --yes codex-overleaf-link@1.1.3 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.1.3 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.1.3 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.1.3 -- uninstall-native --browser chromium` |
429
423
  | Manifest/registry path | `~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.codex.overleaf.json` | `HKCU\Software\Google\Chrome\NativeMessagingHosts\com.codex.overleaf` -> `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime\com.codex.overleaf.json` | `~/.config/google-chrome/NativeMessagingHosts/com.codex.overleaf.json` | `~/.config/chromium/NativeMessagingHosts/com.codex.overleaf.json` |
430
424
  | Bridge/runtime/source path | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `%LOCALAPPDATA%\CodexOverleaf\codex-overleaf-bridge.cmd`; runtime `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime`; source `%LOCALAPPDATA%\CodexOverleaf\source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. |
431
425
  | Node/Git/Codex/TeX | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. |
package/extension/src/shared/compatibility.js CHANGED
@@ -12,7 +12,7 @@
12
12
  const MIN_NATIVE_VERSION = '1.0.0';
13
13
  const MIN_COMPATIBLE_NATIVE_VERSION = '1.0.0';
14
14
  const MIN_COMPATIBLE_EXTENSION_VERSION = '1.0.0';
15
- const BUILD_TARGET_VERSION = '1.1.2';
15
+ const BUILD_TARGET_VERSION = '1.1.3';
16
16
  const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
17
17
  const REQUIRED_CAPABILITIES = Object.freeze([
18
18
  'bridgePing',
package/package.json CHANGED
@@ -1,9 +1,17 @@
1
1
  {
2
2
  "name": "codex-overleaf-link",
3
- "version": "1.1.2",
3
+ "version": "1.1.3",
4
4
  "description": "Cross-platform Chrome bridge that connects Codex to the active Overleaf project.",
5
5
  "license": "MIT",
6
6
  "type": "commonjs",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/Ghqqqq/codex-overleaf-link.git"
10
+ },
11
+ "bugs": {
12
+ "url": "https://github.com/Ghqqqq/codex-overleaf-link/issues"
13
+ },
14
+ "homepage": "https://github.com/Ghqqqq/codex-overleaf-link#readme",
7
15
  "scripts": {
8
16
  "agent:codex": "node scripts/codex-json-agent.mjs",
9
17
  "test": "node scripts/run-tests.mjs",