muffintui

muffintui is a Rust terminal workspace for working inside a project directory with four panes:

• Files
• Editor
• Terminal
• Codex

It starts in the current working directory and uses that directory as:

• the root of the file tree
• the working directory for shell commands
• the working directory for the embedded codex session

Requirements

• Rust and Cargo
• codex installed and available on PATH

Install

Install from crates.io:

cargo install muffintui

Install from the local checkout:

cargo install --path .

Run

Launch in the current directory:

muffintui

Launch against another project:

cd /path/to/project
muffintui

Run without installing during local development:

cargo run

What It Does

• Shows a navigable file tree rooted at the current directory
• Opens the selected file in a read-only editor pane
• Toggles an editor diff mode against HEAD~1
• Runs shell commands inside the built-in terminal pane with sh -lc
• Embeds a live codex terminal session in the right pane
• Cycles between three built-in themes

Notes:

• .git and target are intentionally hidden from the file tree
• Diff mode falls back to a message when the repository has no HEAD~1
• If the initial codex launch fails, pressing Enter in the Codex pane retries the session

Keybindings

Global

• Tab: move focus to the next pane
• Shift+Tab: cycle the theme
• Esc: quit
• Ctrl+C: quit when focus is not in the Codex pane

Files Pane

• Up or k: move selection up
• Down or j: move selection down
• Enter on a directory: expand or collapse it
• Enter on a file: open it in the editor pane

Editor Pane

• Ctrl+D: toggle normal view and diff view
• PageUp: scroll up
• PageDown: scroll down

Terminal Pane

• Type directly into the prompt
• Enter: run the current command
• Backspace: delete one character
• PageUp: scroll back
• PageDown: scroll forward
• Home: jump to the oldest visible terminal history
• End: jump back to the live prompt

Codex Pane

• Regular typing: send input to the embedded codex session
• Enter: submit input, or retry the session if startup failed
• Ctrl+C: send interrupt to codex
• Arrow keys, PageUp, PageDown, Home, End, Tab, Backspace: forwarded to the embedded session

Publish

Before publishing:

cargo package

Then publish:

cargo publish