Pitago

https://github.com/user-attachments/assets/93bfcae4-b02e-429d-a302-d2df850f71a7

_A polished Terminal User Interface (TUI) frontend for the pi agent, built with Bubble Tea. pi --mode rpc serves as the backend (multi-provider, tools, sessions, compaction), while pitago provides a rich terminal interface communicating over JSONL._

Screenshots

Install

From source:

Uninstall

Quick Start

Commands & keybindings

Commands

Type / to open the command popup. Builtins are intercepted locally and re-implemented over
RPC; extension/prompt/skill commands come from pi's get_commands and run server-side.

Keybindings

Shell mode

Type ! on an empty input to switch the editor into a local shell: Enter runs the line, Esc
leaves the mode and kills the process. Nothing typed in shell mode ever reaches pi — no turn, no
session entry — so the command is yours, not the model's. (!cmd still goes to pi, unchanged.)

One long-lived shell runs every line with the session cwd, so cd, export and shell variables
persist between commands. The program is $SHELL (see /settings → Pitago → Shell binary for
an override: $SHELL or an absolute path). Commands run one at a time with an empty stdin and no
terminal, so a typo'd quote reports a syntax error, cat/read see end-of-file and sudo/ssh
password prompts fail fast instead of hanging the mode. A block
shows the first 12 output lines (Ctrl+G shows all) and keeps the first 16 KB of a command's output,
so one chatty command cannot slow down typing afterwards.

pi's own !cmd escape (a fresh process per command, output visible to the model) is untouched.

Copying text and messages

▶ Video demo

Whole-message copy preserves raw Markdown, tables, fenced-code languages, and links; partial
drag selection copies visible text without ANSI/OSC…