Skip to content

docs(readme): correct Pi session completeness from High to Full (#1021) - #1061

Open
gegemeimingzi wants to merge 1 commit into
mksglu:nextfrom
gegemeimingzi:docs/readme-pi-hook-support
Open

docs(readme): correct Pi session completeness from High to Full (#1021)#1061
gegemeimingzi wants to merge 1 commit into
mksglu:nextfrom
gegemeimingzi:docs/readme-pi-hook-support

Conversation

@gegemeimingzi

Copy link
Copy Markdown

What / Why / How

Fixes #1021.

What — Update the README hook-support table to mark Pi as Full (was High) and fill in the two hooks that were incorrectly shown as missing.

Why — The table checked for literal Claude Code hook names instead of whether the Pi adapter actually implements the functionality. The Pi extension (src/adapters/pi/extension.ts) registers 10 pi.on() handlers covering all 5 continuity hooks:

Claude Code hook Pi event Status
PreToolUse tool_call ✓ already shown
PostToolUse tool_result ✓ already shown
UserPromptSubmit before_agent_start was --, now ✓
Stop turn_end was --, now ✓
PreCompact session_before_compact ✓ already shown
SessionStart session_start + context ✓ already shown

This is the same surrogate-event pattern used by OpenCode (chat.message for UserPromptSubmit) which is already rated Full.

How — 4-line change in README.md: fill UserPromptSubmit and Stop cells for Pi, change High → Full in the summary row, and update the explanatory note.

Affected platforms

  • Claude Code
  • Cursor
  • VS Code Copilot (GitHub Copilot)
  • JetBrains Copilot
  • Gemini CLI
  • Qwen Code
  • OpenCode
  • KiloCode
  • Codex CLI
  • OpenClaw (Pi Agent)
  • Pi
  • Kiro
  • Antigravity
  • Zed
  • All platforms

Test plan

Documentation-only change, no code affected.

Checklist

  • Tests added/updated (TDD: red → green) — n/a (docs only)
  • npm test passes — not affected
  • npm run typecheck passes — not affected
  • Docs updated if needed (README, platform-support.md) — ✅ this PR
  • No Windows path regressions (forward slashes only)
  • Targets next branch (unless hotfix)

…lu#1021)

The hook support table marked Pi as High and showed UserPromptSubmit
and Stop as missing (--). In reality the Pi adapter covers both via
native extension events:

  - UserPromptSubmit → before_agent_start
  - Stop → turn_end

This is the same surrogate pattern used by OpenCode (chat.message for
UserPromptSubmit, experimental.chat.system.transform for SessionStart)
which is already marked Full. Update the table and the explanatory
note to reflect Pi's actual coverage.
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.

1 participant