Skip to content

tsumugi-cli v0.1.3

Choose a tag to compare

View all tags
@archfill archfill released this 16 Jun 15:45
· 43 commits to main since this release
cli-v0.1.3
c358294
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Bugfix release. Codex で hook が登録・実行されない 3 段の原因を全て解消。

解消された問題 (調査結果)

v0.1.2 まで codex plugin add で plugin install までは進むものの、hook が登録されない問題があった。Codex 公式 docs を確認した結果、原因は 3 段:

  1. hook ファイル名/参照のズレ — Codex の plugin-bundled hooks 既定は hooks/hooks.json。v0.1.2 までは hooks/codex-hooks.json という独自名で、.codex-plugin/plugin.json に "hooks" の明示も無く、Codex から hook が発見されていなかった。
  2. plugin install / enable は OK — [plugins."tsumugi@archfill"] enabled = true は立っていた。v0.1.2 の codex plugin add 修正は正解。
  3. script path の cache packaging 問題 — codex plugin add は plugin source (integrations/codex/) のみを cache に copy するため、${PLUGIN_ROOT}/../shared/scripts/... の親階層参照は cache では成立しない (../shared/scripts/ が存在しない)。

加えて Codex 公式仕様として、plugin-bundled hooks は trust 承認まで skip される (参照: Codex Hooks: Plugin-bundled hooks)。

What changed

Plugin layout の刷新

  • integrations/codex/hooks/codex-hooks.json → integrations/codex/hooks/hooks.json (Codex 既定名にリネーム、manifest 指定不要)
  • Python script を各 plugin dir 内に duplicate:
    • integrations/claude-code/scripts/{_lib,session_start,user_prompt_submit,pre_tool_use_read}.py
    • integrations/codex/scripts/{_lib,session_start,user_prompt_submit,pre_tool_use_read}.py
  • integrations/shared/scripts/ を削除 (各 plugin が self-contained)
  • 親階層参照 ${VAR}/.. を全廃

hooks.json のパス更新

  • Claude Code: ${CLAUDE_PLUGIN_ROOT}/scripts/...
  • Codex: ${PLUGIN_ROOT}/scripts/...

CLI / docs 改善

  • install 完了 outro に Codex の hook trust 承認案内 を追加 (公式 docs リンク付き)
  • integrations/codex/README.md に hook trust 承認手順の節を追加

Upgrade from v0.1.1 / v0.1.2

強制再 clone で新レイアウトを取得して再 install してください:

npx @archfill/tsumugi-cli@0.1.3 install --platform=codex -f

Codex を再起動した最初の session で hook trust プロンプトが出るので、SessionStart / UserPromptSubmit / PreToolUse(Read) をそれぞれ approve してください (公式仕様)。

承認状態は config.toml で確認:

grep '\[hooks.state."tsumugi@archfill:hooks/hooks.json' ~/.codex/config.toml
# 各 event の trusted_hash エントリが出ていれば成功

Side effects

  • script の duplicate により plugin source の合計サイズが ~10KB 増加
  • shared/scripts/ 廃止により Claude Code と Codex でスクリプト並行メンテが必要 (small footprint なので問題限定的)

Links

Assets 2
Loading