git404hub

what is pi-tidy-tools fr?

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

Analysis updated 2026-05-18

53TypeScriptAudience · developerComplexity · 2/5Setup · easy

tl;dr

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

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

what's the stack?

TypeScriptNode.jsnpm workspaces

how it stacks up fr

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 i run it?

Difficulty · easy time til it works · 5min

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

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.