git404hub

what is pitty fr?

mistrjirka/pitty — explained in plain English

Analysis updated 2026-05-18

55TypeScriptAudience · developerComplexity · 2/5LicenseSetup · moderate

tl;dr

PiTTy is a separate, faster terminal interface for the Pi coding agent, replacing Pi's built-in TUI while reusing its logins, models, sessions, and tools.

vibe map

mindmap
  root((PiTTy))
    What it does
      New frontend for Pi
      Scrollable transcript
      Reuses Pi ecosystem
    Tech stack
      TypeScript
      OpenTUI
      SolidJS
      Bun
    Use cases
      Inspect subagent chats
      Steer running tasks
      Review code diffs
    Audience
      Developers
      Pi users
    Setup
      One command install
      Needs Pi CLI

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Get a scrollable, searchable terminal interface for the Pi coding agent instead of its built-in TUI.

VIBE 2

Inspect and follow subagent conversations separately from the main chat.

VIBE 3

Send steering messages or pause running Pi tasks from the same interface.

VIBE 4

Review edit and write tool diffs more clearly during long coding sessions.

what's the stack?

TypeScriptOpenTUISolidJSBun

how it stacks up fr

mistrjirka/pittyclaude-code-ai-anthropic/free-claude-code-ai-desktop-appsverklo/sverklo
Stars555555
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity2/51/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Node.js 22.19 or newer, npm, and the Pi CLI already installed before running the installer.

MIT license: use, modify, and distribute freely, including for commercial projects, as long as you keep the copyright notice.

in plain english

PiTTy is a separate, fast terminal interface built for a coding agent called Pi. Rather than being an extension that plugs into Pi's existing terminal screen, PiTTy replaces that whole screen with its own scrollable, more inspectable interface, while still using Pi underneath for the actual agent work: its logins, providers, models, sessions, tools, skills, prompt templates, and extensions all stay the same. Installing PiTTy is a single command on Linux, macOS, or WSL, or a PowerShell script on Windows. It requires Node.js 22.19 or newer, npm, and the Pi CLI already installed. The installer checks these requirements, downloads a specific release, verifies it against a published checksum, sets up PiTTy's own local Bun runtime, and creates launcher commands called pitty and pitty resume. Installing PiTTy does not replace or interfere with a normal Pi installation, so both can be used side by side. The reason to use PiTTy instead of Pi's built in terminal comes down to a handful of things: it lets you inspect subagent conversations separately from the main chat, control work while it is running by sending steering messages or pausing tasks, keep the visible workspace calmer since the prompt stays fixed while the conversation scrolls on its own, show clearer diff views when code changes are made, and search through past sessions and models more easily. PiTTy is written in TypeScript, using a library called OpenTUI together with SolidJS for a declarative, reactive interface, and it runs on a local Bun runtime. It aims to support Pi's existing ecosystem of commands, tools, prompt templates, and skills rather than create a separate incompatible one, though some highly customized visual extensions in Pi cannot yet be shown exactly as they appear in Pi itself, and Pi's login flow still needs to be completed in regular Pi. The project is licensed under MIT, so it can be used, modified, and shared freely, including for commercial purposes.

prompts (copy fr)

prompt 1
Install PiTTy with the curl install script and start it with the pitty command in my project.
prompt 2
Explain how PiTTy differs from a regular Pi extension and why it replaces the whole frontend.
prompt 3
Show me how to inspect a subagent's conversation separately using PiTTy.
prompt 4
Help me troubleshoot the PiTTy installer if my Node.js or Pi CLI version does not meet requirements.

Frequently asked questions

what is pitty fr?

PiTTy is a separate, faster terminal interface for the Pi coding agent, replacing Pi's built-in TUI while reusing its logins, models, sessions, and tools.

What language is pitty written in?

Mainly TypeScript. The stack also includes TypeScript, OpenTUI, SolidJS.

What license does pitty use?

MIT license: use, modify, and distribute freely, including for commercial projects, as long as you keep the copyright notice.

How hard is pitty to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pitty for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.