@slix/pi-file-tracker

A persistent widget for the pi coding agent that sits above the text input and lists every file the agent has touched during the session — created, edited, or deleted — updated in real time.

Install

pi install npm:@slix/pi-file-tracker

Activates automatically — no configuration needed. Run /reload if pi is already open.

What it shows

── Edited files (3/9) ────────────────────────────────────────────
   | app.ts | src ✎3                                    +42 -7
 ✚ | new.json | config ✎1                               +12 -0
 ✖ | old-utils.ts | src
  … 6 older files hidden  ·  /file-tracker all

Files are listed newest-first (most recently touched at the top). When the count exceeds the configured limit a dim footer shows how many older files are hidden.

| Element | Meaning | |---------|---------| | (3/9) | 3 shown out of 9 total tracked this session | | +N (green) | Lines added across all edits to that file | | -N (red) | Lines removed (always shown, 0 if none) | | ✎N (yellow) | Number of separate edit/write operations | | ✚ (green) | File was created new during this session | | ✖ (red) | File was deleted during this session |

Stats are right-aligned to the terminal edge. Filenames are shown bold, followed by the parent directory path.

What gets tracked

Every file change the agent makes is captured, regardless of how it happens:

| Source | What's detected | |--------|----------------| | edit tool | Exact diff via pi's EditToolDetails | | write tool | LCS diff against the previous file content | | bash tool | Full filesystem snapshot diff — catches sed -i, cp, mv, touch, output redirections, rm, and anything else |

The bash tracking takes a directory snapshot before and after every shell command, so no file operation is missed.

Commands

| Command | Effect | |---------|--------| | /file-tracker | Toggle the widget on/off | | /file-tracker chars | Switch between line-count and character-count display | | /file-tracker clear | Reset the tracked files list | | /file-tracker all | Toggle show-all mode — reveal every tracked file regardless of the limit | | /file-tracker limit <N> | Set a custom visible-file limit (default: 8); also exits show-all mode |

File limit

By default only the 8 most recently touched files are shown. This keeps the widget compact during long sessions without losing history.

• Use /file-tracker all to temporarily expand to the full list (the header will drop the / counter, e.g. Edited files (9)).
• Use /file-tracker limit 20 to raise the cap permanently for the session.
• When the limit is active and there are hidden files, the footer shows … N older files hidden · /file-tracker all.

The limit and show-all state are both persisted to the session file, so they survive restarts.

Session persistence

State is saved to the session file after every change via pi.appendEntry, so the file list survives restarts and session resumes. It is also branch-aware: navigating the session tree with /tree rebuilds the list from the active branch, so the widget always reflects only the files touched on the current conversation path.