From b75383fb99003fd97ba05931093dde62da7cff3d Mon Sep 17 00:00:00 2001 From: Sisyphus Date: Fri, 2 Jan 2026 00:31:04 +0900 Subject: [PATCH] docs: add npx alternative and Snap Bun warning for Ubuntu users (#401) Closes #389 - Add npx as alternative when bunx doesn't work - Add warning about Snap-installed Bun not working with bunx - Update all localized READMEs (ko, ja, zh-cn) with same changes Co-authored-by: sisyphus-dev-ai --- README.ja.md | 4 ++++ README.ko.md | 4 ++++ README.md | 4 ++++ README.zh-cn.md | 4 ++++ 4 files changed, 16 insertions(+) diff --git a/README.ja.md b/README.ja.md index dabbfa8..9b95465 100644 --- a/README.ja.md +++ b/README.ja.md @@ -223,8 +223,12 @@ OpenCode がインストールされていない場合は、[OpenCode インス ```bash bunx oh-my-opencode install --no-tui --claude= --chatgpt= --gemini= +# bunx が動作しない場合は npx を使用 +npx oh-my-opencode install --no-tui --claude= --chatgpt= --gemini= ``` +> **Ubuntu/Debian ユーザーへの注意**: Snap で Bun をインストールした場合 (`/snap/bin/bun`)、Snap のサンドボックス化により `bunx` が「script not found」エラーで失敗します。代わりに `npx` を使用するか、公式インストーラーで Bun を再インストールしてください: `curl -fsSL https://bun.sh/install | bash` + **例：** - すべてのサブスクリプション + max20: `bunx oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes` - Claude のみ（max20 なし）: `bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=no --gemini=no` diff --git a/README.ko.md b/README.ko.md index 2781caa..0eb7244 100644 --- a/README.ko.md +++ b/README.ko.md @@ -220,8 +220,12 @@ OpenCode가 설치되어 있지 않다면, [OpenCode 설치 가이드](https://o ```bash bunx oh-my-opencode install --no-tui --claude= --chatgpt= --gemini= +# bunx가 작동하지 않으면 npx 사용 +npx oh-my-opencode install --no-tui --claude= --chatgpt= --gemini= ``` +> **Ubuntu/Debian 사용자 참고**: Snap으로 Bun을 설치한 경우 (`/snap/bin/bun`), Snap의 샌드박싱으로 인해 `bunx`가 "script not found" 오류와 함께 실패합니다. 대신 `npx`를 사용하거나, 공식 설치 스크립트로 Bun을 재설치하세요: `curl -fsSL https://bun.sh/install | bash` + **예시:** - 모든 구독 + max20: `bunx oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes` - Claude만 (max20 없음): `bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=no --gemini=no` diff --git a/README.md b/README.md index 0c90ec2..41712c0 100644 --- a/README.md +++ b/README.md @@ -204,8 +204,12 @@ Run the interactive installer: ```bash bunx oh-my-opencode install +# or use npx if bunx doesn't work +npx oh-my-opencode install ``` +> **Note for Ubuntu/Debian users**: If you installed Bun via Snap (`/snap/bin/bun`), `bunx` will fail with "script not found" due to Snap's sandboxing. Either use `npx` instead, or reinstall Bun via the official installer: `curl -fsSL https://bun.sh/install | bash` + Follow the prompts to configure your Claude, ChatGPT, and Gemini subscriptions. After installation, authenticate your providers as instructed. **Alternative: Let an LLM Agent do it** diff --git a/README.zh-cn.md b/README.zh-cn.md index c11faa8..daefd4c 100644 --- a/README.zh-cn.md +++ b/README.zh-cn.md @@ -231,8 +231,12 @@ fi ```bash bunx oh-my-opencode install --no-tui --claude= --chatgpt= --gemini= +# 如果 bunx 不好使就换 npx +npx oh-my-opencode install --no-tui --claude= --chatgpt= --gemini= ``` +> **Ubuntu/Debian 用户注意**：如果你是用 Snap 装的 Bun (`/snap/bin/bun`)，由于 Snap 的沙箱机制，`bunx` 会报 "script not found" 错误。要么改用 `npx`，要么用官方脚本重装 Bun：`curl -fsSL https://bun.sh/install | bash` + **例子：** - 全套订阅 + max20：`bunx oh-my-opencode install --no-tui --claude=max20 --chatgpt=yes --gemini=yes` - 只有 Claude（没 max20）：`bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=no --gemini=no`