Skip to content

Re-land #8387: fix(update): keep bun's postinstall enabled on npm 11 and diagnose a skipped one #8409

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lidge-jun merged 1 commit into from
Nov 9, 2026
Merged

Re-land #8387: fix(update): keep bun's postinstall enabled on npm 11 and diagnose a skipped one #8409

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS_INSTALL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ A host that has both a Task Scheduler entry and a WinSW service is in a conflict

### The CLI

`npm install -g @bitkyc08/opencodex` puts `ocx` on the PATH from npm's global prefix, and the
`npm install -g --allow-scripts=bun @bitkyc08/opencodex` puts `ocx` on the PATH from npm's global prefix, and the
Bun runtime it needs is bundled inside that package. There is no separate runtime to install and
no WSL layer on Windows.

Expand Down
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ and connect OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code and more throug
</p>

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx start
```

Expand Down Expand Up @@ -94,7 +94,7 @@ providers with Codex, Claude Code, Claude Desktop, Grok Build and the tools list
### Personal install (CLI)

```bash
npm install -g @bitkyc08/opencodex # Node 18+; the Bun runtime is bundled automatically
npm install -g --allow-scripts=bun @bitkyc08/opencodex # Node 18+; the Bun runtime is bundled automatically
ocx start # proxy + dashboard on localhost:10100
```

Expand Down Expand Up @@ -253,7 +253,7 @@ they reach the npm package.
<summary>For agents</summary>

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx start # or `ocx service`
ocx init # interactive setup: writes ~/.opencodex/config.json and wires Codex
```
Expand Down
2 changes: 1 addition & 1 deletion bin/ocx.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -331,7 +331,7 @@ async function runPackageManagerSelfUpdate(manager, child) {
const latestInvocation = managerInvocation(["view", `${PKG}@${selector}`, "version"]);
const installArgs = manager === "pnpm"
? ["add", "-g", "--allow-build=bun", `${PKG}@${selector}`]
: ["install", "-g", `${PKG}@${selector}`];
: ["install", "-g", "--allow-scripts=bun", `${PKG}@${selector}`];
const installInvocation = managerInvocation(installArgs);
if (!latestInvocation || !installInvocation) {
console.error(`opencodex: could not resolve ${manager} from a trusted absolute PATH entry; aborting before stopping the proxy.`);
Expand Down
6 changes: 3 additions & 3 deletions docs-site/src/components/Landing.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -165,14 +165,14 @@ const providers: { label: string; path?: string }[] = [
];

const quickstartMini = [
{ cmd: 'npm install -g @bitkyc08/opencodex', note: t('Install', '설치', '安装', 'Установка', 'インストール', '安裝', 'Kurulum') },
{ cmd: 'npm install -g --allow-scripts=bun @bitkyc08/opencodex', note: t('Install', '설치', '安装', 'Установка', 'インストール', '安裝', 'Kurulum') },
{ cmd: 'ocx init', note: t('Add a provider and connect Codex', '프로바이더 추가 후 Codex 연결', '添加提供商并连接 Codex', 'Добавьте провайдера и подключите Codex', 'プロバイダーを追加して Codex を接続', '新增供應商並連接 Codex', 'Sağlayıcı ekleyip Codex’i bağlayın') },
{ cmd: 'ocx start', note: t('Start the proxy', '프록시 시작', '启动代理', 'Запуск прокси', 'プロキシを起動', '啟動代理', "Proxy'yi başlatın") },
{ cmd: 'ocx claude', note: t('In another terminal: launch Claude Code through ocx', '다른 터미널에서: ocx를 거쳐 Claude Code 실행', '在另一个终端中：通过 ocx 启动 Claude Code', 'В другом терминале: запуск Claude Code через ocx', '別のターミナルで: ocx 経由で Claude Code を起動', '在另一個終端機中：透過 ocx 啟動 Claude Code', 'Başka bir terminalde: Claude Code’u ocx üzerinden başlatın') },
];

const quickstart = [
{ cmd: 'npm install -g @bitkyc08/opencodex', note: t('Install', '설치', '安装', 'Установка', 'インストール', '安裝', 'Kurulum') },
{ cmd: 'npm install -g --allow-scripts=bun @bitkyc08/opencodex', note: t('Install', '설치', '安装', 'Установка', 'インストール', '安裝', 'Kurulum') },
{ cmd: 'ocx init', note: t('Add a provider and connect Codex', '프로바이더 추가 후 Codex 연결', '添加提供商并连接 Codex', 'Добавьте провайдера и подключите Codex', 'プロバイダーを追加して Codex を接続', '新增供應商並連接 Codex', 'Sağlayıcı ekleyip Codex’i bağlayın') },
{ cmd: 'ocx start', note: t('Start the proxy', '프록시 시작', '启动代理', 'Запуск прокси', 'プロキシを起動', '啟動代理', "Proxy'yi başlatın") },
{ cmd: 'codex "Write a hello world in Rust"', note: t('Codex now routes through ocx', 'Codex가 ocx를 경유', 'Codex 现在经由 ocx 路由', 'Codex теперь работает через ocx', 'Codex は ocx 経由に', 'Codex 現在經由 ocx 路由', 'Codex artık ocx üzerinden yönlendirilir') },
Expand Down Expand Up @@ -344,7 +344,7 @@ const docsMap = [
</details>
<p class="lp-dl-foot">
{t('Prefer the terminal?', '터미널이 더 편하다면', '更喜欢终端？', 'Предпочитаете терминал?', 'ターミナル派ですか？', '偏好終端機？', 'Terminali mi tercih edersiniz?')}
<code>npm install -g @bitkyc08/opencodex</code>
<code>npm install -g --allow-scripts=bun @bitkyc08/opencodex</code>
<a href={`${prefix}getting-started/installation/`}>{t('Installation guide', '설치 가이드', '安装指南', 'Руководство по установке', 'インストールガイド', '安裝指南', 'Kurulum kılavuzu')}</a>
<a href="https://github.com/lidge-jun/opencodex/releases/latest">{t('All releases and checksums', '전체 릴리스와 체크섬', '所有版本与校验和', 'Все релизы и контрольные суммы', 'すべてのリリースとチェックサム', '所有版本與校驗碼', 'Tüm sürümler ve sağlama toplamları')}</a>
<a href={`${prefix}guides/desktop-app/`}>{t('Desktop app guide', '데스크톱 앱 가이드', '桌面应用指南', 'Руководство по приложению', 'デスクトップアプリガイド', '桌面應用程式指南', 'Masaüstü uygulaması kılavuzu')}</a>
Expand Down
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/fr/getting-started/for-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ disponible pour une configuration interactive ; consultez le [tableau de bord w
Installez le package publié et confirmez que `ocx` est sur `PATH` :

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx --version
```

Expand Down
4 changes: 2 additions & 2 deletions docs-site/src/content/docs/fr/getting-started/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ ChatGPT lorsqu’un modèle routé en a besoin.
## Installer

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
```

:::note[npm a-t-il bloqué le script postinstall de bun ?]
Expand Down Expand Up @@ -52,7 +52,7 @@ les entrées du catalogue n’accordent aucun accès par elles-mêmes. N’utili
tester des versions opencodex non encore publiées :

```bash
npm install -g @bitkyc08/opencodex@preview
npm install -g --allow-scripts=bun @bitkyc08/opencodex@preview
ocx update --tag preview
```

Expand Down
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/fr/troubleshooting/windows-memory.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,4 @@ Si vous essayez l’une de ces solutions avec une charge Windows réelle, veuill

L’installation et la réparation du service Windows ainsi que l’installation et l’actualisation du shim Codex vérifient que l’exécutable sélectionné peut créer puis supprimer un répertoire dans la racine de configuration OpenCodex. Ce contrôle de politique d’écriture ne corrige pas la mémoire. Un échec refuse l’opération avant tout arrêt, téléchargement, préparation ou écriture de jeton ou de lanceur. La réparation automatique du shim est différée avec des instructions et le démarrage continue. Les shims sains ou désactivés ne sont pas testés. Aucun autre runtime n’est recherché. Une première installation du planificateur enregistre sa tâche et revendique la racine de configuration avant ce contrôle ; en cas de refus, cet enregistrement est annulé et la racine revendiquée est conservée pour une nouvelle tentative.

> Le runtime Bun sélectionné ne peut pas créer puis supprimer un répertoire de configuration. La politique d’application Windows peut interdire les écritures depuis cet emplacement. Avant de lancer `ocx`, définissez `OPENCODEX_BUN_PATH` vers un exécutable Bun de confiance autorisé par votre politique, ou réinstallez avec `npm install -g @bitkyc08/opencodex`, puis réessayez. Aucun autre runtime n’a été sélectionné.
> Le runtime Bun sélectionné ne peut pas créer puis supprimer un répertoire de configuration. La politique d’application Windows peut interdire les écritures depuis cet emplacement. Avant de lancer `ocx`, définissez `OPENCODEX_BUN_PATH` vers un exécutable Bun de confiance autorisé par votre politique, ou réinstallez avec `npm install -g --allow-scripts=bun @bitkyc08/opencodex`, puis réessayez. Aucun autre runtime n’a été sélectionné.
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/getting-started/for-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ available for interactive configuration; see [Web Dashboard](/guides/web-dashboa
Install the published package and confirm that `ocx` is on `PATH`:

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx --version
```

Expand Down
10 changes: 8 additions & 2 deletions docs-site/src/content/docs/getting-started/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ for one package invocation. That bypass does not repair the Desktop record, shim
## Install

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
```

With pnpm 10.4 or later:
Expand Down Expand Up @@ -70,6 +70,12 @@ npm install -g --allow-scripts=bun @bitkyc08/opencodex
# if the original install used sudo, keep using sudo:
sudo npm install -g --allow-scripts=bun @bitkyc08/opencodex
```

On Windows a running proxy keeps `node_modules\bun\bin` open, so a manual
`npm install -g` fails with `EBUSY`. `ocx update` stops the proxy and restarts the service itself;
for a manual reinstall, stop it first (`ocx stop`), install, then restart through the owning service
(`ocx service restart`) or `ocx start` when unmanaged. `ocx doctor` prints this sequence when it finds
a package install whose bundled runtime never unpacked.
:::

Verify both command aliases are on your `PATH`:
Expand Down Expand Up @@ -116,7 +122,7 @@ the catalog entries do not grant access by themselves. Use the preview channel o
unreleased opencodex builds:

```bash
npm install -g @bitkyc08/opencodex@preview
npm install -g --allow-scripts=bun @bitkyc08/opencodex@preview
ocx update --tag preview
```

Expand Down
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/ja/getting-started/for-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: ユーザー同意の境界を越えずに、エージェント主
公開されたパッケージをインストールし、`ocx` が `PATH` 上にあることを確認します。

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx --version
```

Expand Down
4 changes: 2 additions & 2 deletions docs-site/src/content/docs/ja/getting-started/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ opencodex をインストールすると同じ実行ファイルを指す `ocx`
## インストール

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
```

:::note[npm が bun の postinstall をブロックした?]
Expand Down Expand Up @@ -63,7 +63,7 @@ GPT-5.6 Sol/Terra/Luna カタログ情報がすでに含まれています。た
ありません。まだ正式配布されていない opencodex ビルドを試す場合のみ preview チャネルを使ってください:

```bash
npm install -g @bitkyc08/opencodex@preview
npm install -g --allow-scripts=bun @bitkyc08/opencodex@preview
ocx update --tag preview
```

Expand Down
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/ja/troubleshooting/windows-memory.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,4 +50,4 @@ Windows では、#32111 クラッシュを回避するために、opencodex は

Windows のサービスのインストール・修復と Codex shim のインストール・更新は、選択した実行ファイルが OpenCodex 設定ルート内でディレクトリを作成・削除できるか確認します。これはメモリ修正ではなく書き込みポリシーの確認です。失敗するとサービス停止、ダウンロード、ステージング、トークンやランチャーの書き込み前に拒否します。shim の自動修復は案内付きで延期され、起動は続行します。正常または無効な shim は検査しません。別のランタイムを自動探索しません。 初回のスケジューラーインストールでは、この確認の前にタスクを登録し設定ルートを確保します。拒否された場合は新しい登録を取り消し、確保したルートは再試行用に残します。

> 選択した Bun ランタイムが設定ディレクトリ内でディレクトリを作成・削除できませんでした。Windows のアプリケーションポリシーがこの実行ファイルの位置からの書き込みを拒否している可能性があります。`ocx` 起動前にポリシーが許可する信頼できる Bun のパスを `OPENCODEX_BUN_PATH` に設定するか、`npm install -g @bitkyc08/opencodex` で再インストールして再試行してください。別のランタイムは選択していません。
> 選択した Bun ランタイムが設定ディレクトリ内でディレクトリを作成・削除できませんでした。Windows のアプリケーションポリシーがこの実行ファイルの位置からの書き込みを拒否している可能性があります。`ocx` 起動前にポリシーが許可する信頼できる Bun のパスを `OPENCODEX_BUN_PATH` に設定するか、`npm install -g --allow-scripts=bun @bitkyc08/opencodex` で再インストールして再試行してください。別のランタイムは選択していません。
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/ko/getting-started/for-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: 사용자의 동의 경계를 넘지 않으면서 에이전트가
배포된 패키지를 설치하고 `ocx`가 `PATH`에 들어 있는지 확인합니다:

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx --version
```

Expand Down
4 changes: 2 additions & 2 deletions docs-site/src/content/docs/ko/getting-started/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ opencodex를 설치하면 같은 실행 파일을 가리키는 `ocx`와 `opencod
## 설치

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
```

:::note[npm이 bun postinstall을 차단했다면?]
Expand Down Expand Up @@ -86,7 +86,7 @@ GPT-5.6 Sol/Terra/Luna 카탈로그 정보가 이미 들어 있습니다. 다만
아닙니다. 아직 정식 배포되지 않은 opencodex 빌드를 시험할 때만 preview 채널을 사용하세요:

```bash
npm install -g @bitkyc08/opencodex@preview
npm install -g --allow-scripts=bun @bitkyc08/opencodex@preview
ocx update --tag preview
```

Expand Down
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/ko/troubleshooting/windows-memory.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,4 @@ Windows에서는 opencodex가 #32111 충돌을 피하기 위해 스트리밍 응

Windows 서비스 설치·복구와 Codex shim 설치·갱신은 선택한 실행 파일이 OpenCodex 설정 루트 안에 디렉터리를 만들고 제거할 수 있는지 검사합니다. 메모리 수정이 아닌 쓰기 정책 검사입니다. 실패하면 서비스 중지, 다운로드, 스테이징, 토큰·실행 파일 쓰기 전에 거부합니다. shim 자동 복구는 안내와 함께 지연되며 시작은 계속됩니다. 정상 상태 또는 비활성화된 shim은 검사하지 않습니다. 다른 런타임을 자동으로 찾지 않습니다. 처음 하는 스케줄러 설치는 이 검사 전에 작업을 등록하고 설정 루트를 확보합니다. 거부되면 새 등록은 되돌리고, 확보한 루트는 재시도를 위해 남겨 둡니다.

> 선택한 Bun 런타임이 OpenCodex 설정 디렉터리 안에 디렉터리를 만들고 제거하지 못했습니다. Windows 애플리케이션 정책이 이 실행 파일 위치의 쓰기를 차단할 수 있습니다. `ocx` 실행 전에 정책이 허용하는 신뢰할 수 있는 Bun 실행 파일로 `OPENCODEX_BUN_PATH`를 설정하거나, `npm install -g @bitkyc08/opencodex`로 다시 설치한 뒤 재시도하세요. 다른 런타임은 선택하지 않았습니다.
> 선택한 Bun 런타임이 OpenCodex 설정 디렉터리 안에 디렉터리를 만들고 제거하지 못했습니다. Windows 애플리케이션 정책이 이 실행 파일 위치의 쓰기를 차단할 수 있습니다. `ocx` 실행 전에 정책이 허용하는 신뢰할 수 있는 Bun 실행 파일로 `OPENCODEX_BUN_PATH`를 설정하거나, `npm install -g --allow-scripts=bun @bitkyc08/opencodex`로 다시 설치한 뒤 재시도하세요. 다른 런타임은 선택하지 않았습니다.
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/ru/getting-started/for-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ description: Установите и используйте opencodex из аг
Установите опубликованный пакет и убедитесь, что `ocx` доступен в `PATH`:

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx --version
```

Expand Down
4 changes: 2 additions & 2 deletions docs-site/src/content/docs/ru/getting-started/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ opencodex устанавливает два эквивалентных имен
## Установка

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
```

:::note[npm заблокировал postinstall-скрипт bun?]
Expand Down Expand Up @@ -66,7 +66,7 @@ ChatGPT, OpenAI по API-ключу, OpenRouter и эксперименталь
Используйте канал preview только для тестирования ещё не выпущенных сборок opencodex:

```bash
npm install -g @bitkyc08/opencodex@preview
npm install -g --allow-scripts=bun @bitkyc08/opencodex@preview
ocx update --tag preview
```

Expand Down
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/ru/troubleshooting/windows-memory.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,4 +91,4 @@ opencodex поставляет рантайм Bun (сейчас это **1.3.14*

Установка и восстановление службы Windows, а также установка и обновление shim Codex проверяют, может ли выбранный исполняемый файл создать и удалить каталог внутри корня конфигурации OpenCodex. Это проверка политики записи, а не исправление памяти. При неудаче операция отклоняется до остановки службы, загрузки, подготовки или записи токена и запускающего файла. Автовосстановление shim откладывается с рекомендацией, запуск продолжается. Исправный или отключённый shim не проверяется. Поиск другой среды не выполняется. При первой установке через планировщик задача регистрируется и корень конфигурации закрепляется до этой проверки; при отказе новая регистрация откатывается, а закреплённый корень остаётся для повторной попытки.

> Выбранная среда Bun не смогла создать и удалить каталог конфигурации. Политика приложений Windows может запрещать запись из этого расположения. До запуска `ocx` задайте `OPENCODEX_BUN_PATH` на доверенный исполняемый файл Bun, разрешённый политикой, либо переустановите через `npm install -g @bitkyc08/opencodex` и повторите попытку. Другая среда не выбиралась.
> Выбранная среда Bun не смогла создать и удалить каталог конфигурации. Политика приложений Windows может запрещать запись из этого расположения. До запуска `ocx` задайте `OPENCODEX_BUN_PATH` на доверенный исполняемый файл Bun, разрешённый политикой, либо переустановите через `npm install -g --allow-scripts=bun @bitkyc08/opencodex` и повторите попытку. Другая среда не выбиралась.
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/tr/getting-started/for-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ kalır; bkz. [Web Kontrol Paneli](/tr/guides/web-dashboard/).
Yayınlanan paketi kurun ve `ocx`'in `PATH` üzerinde olduğunu doğrulayın:

```bash
npm install -g @bitkyc08/opencodex
npm install -g --allow-scripts=bun @bitkyc08/opencodex
ocx --version
```

Expand Down
Loading
Loading