packages / normful-pi-show-files-read
extension Session utilities

@normful/pi-show-files-read

Track and display every file the agent has read in the current Pi session via a /files-read modal

No reviews yet

Install

$ pi install npm:@normful/pi-show-files-read

Installs from npm into ~/.pi/agent/. Add -l for project-local (.pi/). Manage with pi list / pi update / pi remove.

What this package can reach

Detected automatically from the source at version 0.5.0. This describes access, not safety — you decide whether it's appropriate for what the package claims to do.

  • ⇄
    Intercepts tools — Can block or rewrite tool calls Subscribes to tool_call/tool_result/input. Can change a command after you approved the one displayed.

What it actually did when run

observed

Loaded in a sandbox with no network, a read-only filesystem and a recording stand-in for pi's API. This is what it called — not what the source suggests it might.

Events subscribed session_starttool_result

APIs called registerCommandui.custom

1 call the source scan did not predict

ui.custom

Reached through a value the scan could not follow — passed as an argument, stored on another object, or returned by a helper.

Run against version 0.5.0 on 2026-08-02. Registration-time behaviour under default settings; other configurations may differ.

▲ Review before you install. pi packages run with your full system permissions. Check the source, pin versions, and prefer authors you trust.

Reviews

0 published

Sign in with GitHub to write a review, reply, or vote.

No reviews yet — be the first.

More in Session utilities

  • @ogulcancelik/pi-quit-and-delete — Keyboard shortcut to quit pi and permanently delete the active session file.
  • @howaboua/pi-auto-trees — A Pi package that adds /marker and /end commands for incremental long-running coding sessi…
  • pi-blueprint — A Pi extension that turns high-level objectives into phased, multi-session construction pl…
  • pi-ephemeral — Toggle Pi session persistence mid-session (delete session file on exit)