whatisgithub

What is pi-tidy-tools?

mikeyobrien/pi-tidy-tools — explained in plain English

Analysis updated 2026-05-18

53TypeScriptAudience · developerComplexity · 2/5Setup · easy

In one sentence

A set of add-on packages that make the Pi coding agent's tool output compact and easy to follow.

Mindmap

mindmap
  root((pi-tidy-tools))
    What it does
      Compact tool output
      Reason first display
      Diff recap
    Tech stack
      TypeScript
      npm workspaces
      Pi agent
    Use cases
      Readable agent transcripts
      Parallel subagent tracking
      Compact terminal footer
    Audience
      Pi agent users
      Developers

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 build with it?

USE CASE 1

Replace Pi's bulky tool-call transcript with compact, reason-first output.

USE CASE 2

Run and monitor multiple child agent tasks in parallel without losing track of results.

USE CASE 3

Add a compact status footer showing model and quota usage in a small terminal window.

What is it built with?

TypeScriptNode.jsnpm workspaces

How does it compare?

mikeyobrien/pi-tidy-toolsalibaba-cloud-design/vibe-designing-playbookellian-eorwyn/hephaestus
Stars535353
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencedeveloperdesignervibe coder

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Experimental packages require installing from a git checkout instead of npm.

So what is it?

pi-tidy-tools is a collection of small, separately installable add-ons for Pi, an AI coding agent. The problem it solves is readability: when Pi runs a long series of tool calls, its default transcript shows every action as a large boxed card, which makes it hard to follow what the agent is actually doing or why. This project replaces that with compact, two-line summaries that show the reasoning behind each action alongside its result. The collection is split into separate packages rather than one big install. The main package, pi-tidy-tools, restyles common actions like reading files, writing files, editing, running shell commands, and searching, so each shows its goal and outcome in one or two lines instead of a large card. It also adds a diff view that recaps what changed in the previous turn. A second package, pi-tidy-subagents, handles cases where Pi delegates work to child agents running in parallel. It shows a compact live status for each child task, can run some of them in the background while you keep working, and reports results in order even if one child task fails while others succeed. Two more packages are still experimental and only available by installing directly from the source code rather than from npm. pi-tidy-memory gives Pi a way to remember information across sessions by connecting to an external memory server. pi-tidy-footer is a compact status bar built for narrow terminal windows, such as those on a phone, showing which model is active and how much of your usage quota remains. Each package is installed independently using Pi's own package installer, and the project maintains test coverage and mutation testing requirements to keep quality consistent across packages.

Copy-paste prompts

Prompt 1
Show me how to install @mobrienv/pi-tidy-tools into my Pi agent setup.
Prompt 2
Explain the difference between pi-tidy-tools and pi-tidy-subagents and when I'd use each.
Prompt 3
Help me install the experimental pi-tidy-memory package from a local git checkout.
Prompt 4
Write a summary of what the /diff recap feature in pi-tidy-tools shows after each turn.

Frequently asked questions

What is pi-tidy-tools?

A set of add-on packages that make the Pi coding agent's tool output compact and easy to follow.

What language is pi-tidy-tools written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, npm workspaces.

How hard is pi-tidy-tools to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pi-tidy-tools for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.