Clean-room Buddy research plus a working Rust wrapper TUI for Codex.

Current wrapper UI with the Buddy side pane visible on the right. This capture shows the wrapper shell and Buddy mascot; a future screenshot would be stronger if it also shows the Buddy action menu or status view in use.

• buddy/ Clean-room Buddy behavior notes, extracted snapshot files, and wrapper-port specs.
• docs/superpowers/plans/ Planning notes for the missing host behavior and the wrapper implementation.
• wrapper/ A Rust ratatui wrapper that hosts stock codex in a PTY and renders an always-visible Buddy side pane.

• PTY-hosted Codex main pane
• Always-visible Buddy side pane
• Focus switching between Codex and Buddy
• Buddy action menu with hatch, status, pet, mute, unmute, and rebirth
• Wrapper-owned Buddy persistence
• Codex hook relay and normalized Buddy events
• codex exec hatch and quip backends

Prerequisites:

• Rust toolchain
• codex on PATH

Launch the wrapper:

cargo run --manifest-path wrapper/Cargo.toml

Controls:

• Tab: switch focus between Codex and Buddy
• Enter: open or activate the Buddy action menu when Buddy is focused
• Up / Down or k / j: move in the Buddy action menu
• Esc: close Buddy menu or status view
• Ctrl+Q: quit the wrapper

cargo test --manifest-path wrapper/Cargo.toml
cargo fmt --manifest-path wrapper/Cargo.toml --check
cargo clippy --manifest-path wrapper/Cargo.toml --all-targets -- -D warnings

• Codex hooks are currently Unix-first; Windows is not the target for this wrapper.
• session_ended is synthesized by the wrapper when the PTY exits because Codex does not expose a documented SessionEnd hook.