cavaldos

Pitago — AI skill for Claude Code

AI community

A polished terminal UI (TUI) for the pi AI coding agent — real-time chat, multi-provider LLMs, tools and sessions.

How to install Pitago

This entry records only its repository, not the path inside it, so there is no exact command to give. Open cavaldos/pitago and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Pitago does

A polished terminal UI (TUI) for the pi AI coding agent — real-time chat, multi-provider LLMs, tools and sessions. Built with Go and Bubble Tea.

Alternatives in AI

Claude Usage Tracker — Native macOS menu bar app for tracking Claude AI usage limits in real-time 2.2k ★
Loushang — AI-native agent harness for coding workflows by python: multi-model LLM orchestration, stateful sessions, tool 1.3k ★
Agor — Orchestrate Claude Code, Codex, and Gemini sessions on a multiplayer canvas 1.2k ★

README

pitago

████  ███ █████  ███   ███   ███
█   █  █    █   █   █ █     █   █
████   █    █   █████ █  ██ █   █
█      █    █   █   █ █   █ █   █
█     ███   █   █   █  ███   ███

![pitago screenshot](resources/Screenshot.png)

![pitago demo](resources/demo.gif)

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.

Overview

pitago wraps the `pi` agent in a beautiful terminal interface with:

Real-time chat with streaming responses
Sidebar showing session info, model details, token usage, and git status
Command palette with builtins and extension commands
File mention support (@file)
Image send via @photo.png or dropping/pasting file paths — or Ctrl+V on a copied screenshot (macOS needs pngpaste, Linux uses wl-paste/xclip). Vision over RPC, max 5 × 8MB. Paths collapse into [Image N] chips; ↓ moves into the tray, ←→ picks a chip, ⌫ deletes it, Esc back
Recent models picker
Clipboard integration (Ctrl+Y to yank last answer)

Requirements

Go ≥ 1.27
pi available in PATH (or set PI_BIN to its path)
An API key for your provider (e.g. ANTHROPIC_API_KEY), or run /login inside the app to save one to the keystore

Install

Option 1 — install into bin (use anywhere)

From a release binary (latest version, pick your OS — single block, no variables):

macOS (Apple Silicon):

curl -L -o pitago https://github.com/cavaldos/pitago/releases/latest/download/pitago-darwin-arm64
chmod +x pitago
sudo mv pitago /usr/local/bin/pitago   # or ~/go/bin, ~/.local/bin — any dir on PATH
pitago --version

macOS (Intel):

curl -L -o pitago https://github.com/cavaldos/pitago/releases/latest/download/pitago-darwin-amd64
chmod +x pitago
sudo mv pitago /usr/local/bin/pitago   # or