---
slug: "furbyhaxx-pi-teardown-screen"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/furbyhaxx/pi-teardown-screen@main/README.md"
repo: "https://github.com/furbyhaxx/pi-teardown-screen"
source_file: "README.md"
branch: "main"
---
# pi-teardown-screen

A slim [pi](https://github.com/earendil-works/pi) coding agent extension that
prints a session **teardown screen** with a resume command and stats (turns,
tokens, cost, duration) when you quit a pi session.

It provides the compact default teardown layout with:

- **Zero configuration** — no settings, flags, or env vars to tune.
- **No custom theme** — uses pi's default theme tokens (`accent`, `muted`,
  `text`) so it adapts to whatever theme is active.

## Install

Install from npm:

```sh
pi install npm:@furbyhaxx/pi-teardown-screen
```

Or install from GitHub:

```sh
pi install git:https://github.com/furbyhaxx/pi-teardown-screen
```

Or clone the repo and install from the local checkout:

```sh
git clone https://github.com/furbyhaxx/pi-teardown-screen
pi install path/to/cloned/repo
```

Or load directly without installing:

```sh
pi -e path/to/cloned/repo/extensions/teardown/index.ts
```

## What it shows

On `quit` of an interactive session, it writes to stderr:

```
╭────╮  Project: ~/work/example
│ Pi │  Environment: auto
╰────╯  Session: 01J...abc
        Title:   refactoring auth module

        Resume:  pie auto --session 01J...abc

        4 turns · 12.3k tokens · $0.04 · 2m 17s
```

If no managed environment is detected, the environment row is omitted and the
resume command falls back to `pi --session <id>`.

## Behavior

- Triggers on `session_shutdown` with `reason === "quit"` only (not on
  `/new`, `/fork`, `/resume`, etc.).
- Skipped when there is no UI (e.g. `--mode json`, `-p`).
- Sections rendered, in order: `project`, `environment` (if detected),
  `session`, `title` (if set), `resume`, `stats` (turns, tokens, cost,
  duration).
- Layout: compact (logo + key/value rows side by side, then a stats row).

## Build

`tsc --noEmit` — no build artifacts are produced; pi loads the `.ts` source
directly via `jiti`.

```sh
npm install
npm run build
```

## License

MIT