Pi Tuix

Pi-TUIX

**Status:** early development. `pi-tuix` is not published to npm yet.

**Pi-TUIX** is an open-source terminal UI extension for the Pi Coding Agent. It adds a clearer, denser interface for long coding sessions while Pi continues to own model requests, built-in tools, sessions, permissions, and provider integrations.

Why Pi-TUIX

When a coding session is long, the hard part is often knowing what is happening, what changed, and whether you need to intervene. Pi-TUIX improves that information hierarchy without moving your work to a second agent runtime.

• See the active model, workspace, and context signal in the shell.
• Keep working and streaming feedback visible without transcript noise.
• Switch back to Pi's default interface in the same session.
• Adopt it as a removable package; Pi remains the system of record.

Quick Start

Install the development version

Requirements: Node.js `>=22.19.0` and Pi Coding Agent `>=0.84.0`.

npm install
npm run check
pi install /absolute/path/to/pi-tuix --approve
pi list

Pi stores the local path in user settings and loads that working tree across projects. Restart Pi after code changes. Use `pi install -l /absolute/path/to/pi-tuix --approve` for a project-local installation, or `pi -e ./extensions/index.ts` for a one-off preview that is not saved.

Install from npm (after the first release)

pi install npm:pi-tuix

For a project-local install, use `pi install -l npm:pi-tuix