pi-codex-theme

Pi with a tighter Codex-inspired terminal UI, maintained as an independent derivative.

Preview

What It Adds

• Bundled codex-dark and codex-light themes tuned for a Codex-like terminal feel.
• Custom header, footer, and editor shell built through Pi extension hooks.
• Compact built-in tool rendering with dot-led summaries and collapsed-first output.
• User and assistant transcript decoration for a denser CLI-style conversation flow.
• Assistant response formatting guidance plus heading normalization to avoid ###-style transcript sections.
• Better Markdown readability in dark surfaces, including clearer headings, links, and inline code.
• Session commands for theme, density, footer detail, reset, and diagnostics.
• Windows clipboard history image picker via /clipboard or Alt+Shift+V.

Compatibility

• Package: @vinyroli/pi-codex-theme
• Tested against the Pi 0.56.x package line declared in peerDependencies
• Requires a Pi setup that supports extensions and packaged themes

Install

Published package:

pi install npm:@vinyroli/pi-codex-theme

Local development:

pi -e .

Commands

• /codex - show current CODEX status and active preferences
• /codex-theme dark|light - switch the active CODEX theme
• /codex-density compact|comfortable - switch transcript and editor density
• /codex-statusline compact|usage|full - switch footer detail level
• /codex-reset - restore default CODEX preferences
• /codex-doctor - print a quick diagnostic report
• /clipboard - open a Windows clipboard history picker for images
• /clipboard <index> - attach a specific image from the Win+V history list

Notes On Clipboard Support

• Clipboard history integration is Windows-only.
• The picker reads image entries from the Win+V history and inserts temporary file paths into the editor.
• The keyboard shortcut is Alt+Shift+V.

Development

bun run fmt
bun run lint
bun run typecheck
bun run check
bun run pack:dry

Repository Notes

• Planning and parity notes live in docs/.
• The package stays at the extension boundary instead of patching Pi core.
• Transcript parity with Codex is intentionally approximate where Pi does not expose internal renderers.

Credits

• Inspired by https://github.com/maria-rcks/pi-dex
• Independently maintained in this repository and not part of the GitHub fork network