Skip to content

fix: macOS の対話インストールで claude CLI が kqueue エラーで失敗する問題を修正(v0.78.2) - #174

Merged
okash1n merged 3 commits into
mainfrom
fix/claude-cli-kqueue-stdin
Oct 6, 2026
Merged

okash1n merged 3 commits into
mainfrom
fix/claude-cli-kqueue-stdin

Conversation

@loadbalance-sudachi-kun

Copy link
Copy Markdown
Contributor

概要

新規 Mac で対話インストール(curl | bash)を実行すると、claude plugin marketplace add / plugin list / plugin install が error: EINVAL: invalid argument, kqueue で失敗し、既定プラグインが 1 つも入らない問題を修正します(v0.78.2)。

原因

  • install.sh は、ウィザードが入力を読めるように setup.sh の stdin を </dev/tty に付け替えて起動する
  • Bun 製のネイティブ claude CLI は、plugin / mcp 系サブコマンドで stdin を kqueue に登録する
  • macOS の kqueue は /dev/tty という別名デバイスを EINVAL で拒否する。実 pty(/dev/ttysNNN)、パイプ、/dev/null であれば成功する
  • 再現手順: script -q /dev/null bash -c 'claude plugin list </dev/tty; echo rc=$?' </dev/null
  • 上流の参考: tty.WriteStream fails with EINVAL: invalid argument, kqueue on macOS when opening /dev/tty oven-sh/bun#24158

ユーザーに見える変更

  • macOS の対話インストールで、既定プラグインのマーケットプレイス追加とインストールが成功するようになる
  • これまでは install_selected_plugins の失敗によって後続の Codex Plugin セットアップ(有効時)と Claude CLI の最終確認がスキップされていたが、修正後は実行される
  • bash setup.sh の直接実行、非対話インストール、Linux / WSL(epoll)は従来どおり影響を受けない
  • 既に失敗した環境は、install.sh の再実行(更新モード)か、/plugin marketplace add ... で復旧できる(CHANGELOG に記載)

変更内容

ファイル 変更
lib/codex-setup.sh _claude_cli() { claude "$@" </dev/null; } を追加し、Codex プラグイン導入とレガシー MCP の判定・削除を経由させた
setup.sh プラグインの一覧取得・marketplace 追加・install を _claude_cli 経由に変更
lib/deploy.sh claude --version に </dev/null を追加
uninstall.sh 自己完結が必要なため、Codex 後片付けの claude 呼び出しに </dev/null を直接追加。確認プロンプトの read は従来どおり利用者の入力を読む
tests/unit/test-codex-setup.sh stdin プローブ(_claude_cli が呼び出し元の stdin を引き継がないこと)と、同梱スクリプト内の claude plugin|mcp|--version 呼び出しが _claude_cli または </dev/null を経由していることの静的ガードを追加。修正前のコードでは 13 箇所を検出する
CHANGELOG.md [0.78.2] - 2026-10-05 の Fixed エントリ

リスク

  • 対象のサブコマンドはいずれも stdin を読まないため、/dev/null に置き換えても挙動は変わらない
  • 静的ガードは grep ベースなので、今後 claude を別の書き方(変数経由など)で呼ぶと検出できない可能性がある
  • 既知の別件として、uninstall.sh の claude uninstall(CLI 2.1.289 にこのサブコマンドが存在しない)は本 PR の範囲外。別 Issue で扱う

実行した検査

  • shellcheck -S warning: 変更した 5 ファイルとも OK
  • tests/unit/test-codex-setup.sh(runner 経由): 19/19 PASS
  • bash tests/run-unit-tests.sh: 833 件中 832 件 PASS。残る 1 件 fonts: direct download fallback receives font definition は main でも同じく FAIL する既知の事象
  • 実 claude CLI で stdin を /dev/tty にした E2E: rc=0
  • MDM スイート(tests/run-mdm-tests.sh): detect は 342 PASS / 1 SKIP。test-mdm-install.sh の 3 件(non-root dry-run の policy / 一時 checkout 系)がローカルで FAIL した
    • この 3 件は環境起因と判断している。このテストはコミット済みの HEAD を git clone し、setup.sh をダミーに差し替えて未変更の mdm/install-mdm.sh だけを使う構造なので、未コミットの差分が入る経路がない。別ユーザー権限で実行される環境依存のテストでもある
    • origin/main 上での再現確認はしていない(約 40 分かかるため)。CI の結果をゲートとする

install.sh は curl | bash でもウィザードが入力を読めるよう setup.sh を
</dev/tty で起動する。Bun 製のネイティブ claude CLI は plugin / mcp 系
サブコマンドで stdin を kqueue に登録するが、macOS の kqueue は /dev/tty
という別名デバイスを拒否するため、claude plugin marketplace add / list /
install が "EINVAL: invalid argument, kqueue" で失敗していた。新規 Mac では
既定プラグインが 1 つも入らず、install_selected_plugins の非 0 終了で
Codex Plugin セットアップと Claude CLI の最終確認も実行されなかった。

- lib/codex-setup.sh: stdin を /dev/null にして claude を実行する
  _claude_cli() を追加し、Codex プラグイン導入・レガシー MCP 判定/削除を
  経由させた
- setup.sh: プラグイン一覧取得・marketplace 追加・install を _claude_cli 経由に
- lib/deploy.sh: claude --version に </dev/null を付与
- uninstall.sh: 自己完結のため Codex 後片付けの claude 呼び出しに
  </dev/null を直接付与(確認プロンプトの read は従来どおり)
- tests/unit/test-codex-setup.sh: _claude_cli が呼び出し元の stdin を
  引き継がないことのプローブと、同梱スクリプトの claude plugin|mcp|--version
  呼び出しを検査する静的ガードを追加(修正前コードでは 13 箇所を検出)

ローカル確認: shellcheck(変更 5 ファイル)、test-codex-setup 19/19、
全ユニット 832/833(残る fonts 1 件は main でも同一の既知 FAIL)、実 claude で
stdin=/dev/tty の E2E rc=0
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-06T06:30:01.040133Z 6e2f696 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

レビューで確認した指摘への対応。

- tests/unit/test-codex-setup.sh: 静的ガードの除外条件を行全体の部分一致から
  呼び出し単位に絞った。表示行の除外は行頭のログ出力コマンドに限り、
  </dev/null は claude コマンド自身のリダイレクトだけを数える。
  `claude plugin list || warn ...` や `claude plugin list; cat </dev/null` の
  ような裸の呼び出しを検出するようになり、`< /dev/null`(空白入り)は
  誤検出しなくなった。検査対象に install.sh と wizard/*.sh を追加し、
  テスト名とコメントを検査範囲(plugin / mcp / --version)に合わせ、
  else 節を字下げした。origin/main に対する検出数は 13 箇所のまま
- CHANGELOG.md: 日付をマージ日に更新。対象を claude plugin / mcp / --version の
  呼び出しと明記し、anthropic-agent-skills の失敗表示は Full プロファイルの
  場合であることを補足
- CLAUDE.md: Key Conventions に _claude_cli() の規約を追加
修正コミットの再レビューで確認した指摘への対応。

- tests/unit/test-codex-setup.sh: `"claude plugin install ...` の除外を文字列だけの
  継続行に限定し、表示行の除外ではコマンド置換より後ろの claude を除外しない
  ようにした。`claude plugin install x || warn "claude plugin install failed"` と
  `info "$(claude --version)"` の形を検出する。origin/main に対する検出数は
  13 箇所のまま
- CHANGELOG.md / CLAUDE.md: リダイレクトを直接書いているのは uninstall.sh だけ
  ではなく lib/deploy.sh のバージョン取得も含むため、記述を実装に合わせた
@okash1n
okash1n merged commit b4eea52 into main Oct 6, 2026
11 checks passed
@okash1n
okash1n deleted the fix/claude-cli-kqueue-stdin branch October 7, 2026 03:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants