whatisgithub

What is pi-inspect?

nikiforovall/pi-inspect — explained in plain English

Analysis updated 2026-05-18

29JavaScriptAudience · developerComplexity · 2/5Setup · easy

In one sentence

A local dashboard that reveals which tools, commands, skills, and system prompt text are loaded in a pi AI coding agent session.

Mindmap

mindmap
  root((pi-inspect))
    What it does
      Shows loaded tools and commands
      Displays system prompt text
      Captures session snapshots
    Tech stack
      Node.js
      pi coding agent
    Use cases
      Session debugging
      Prompt inspection
      Snapshot sharing
    Audience
      Developers
      pi CLI users
    Setup
      One command npm install
      Runs on localhost

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

Inspect exactly which tools and slash commands are active in a current pi coding session.

USE CASE 2

Compare the full system prompt loaded into a past versus current session.

USE CASE 3

Share a self-contained snapshot link of a session's configuration with a teammate.

What is it built with?

JavaScriptNode.js

How does it compare?

nikiforovall/pi-inspectable-rip/cc-visionrouteraisatan/poe2dire
Stars292929
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Installed as an npm package from inside the pi CLI, no external services required.

So what is it?

pi-inspect is a dashboard that shows what a coding-agent session has actually loaded into itself. It is built for an AI coding tool called pi, made by pi.dev, and it answers a question that is easy to ask but hard to check from the chat window: which tools, slash commands, skills, and system-prompt text are present in this particular session right now? Installation is one command typed inside pi: 'pi install npm:pi-inspect'. After that, the user controls the dashboard with a slash command also typed inside pi, '/inspect'. The README lists the variants: '/inspect' opens the dashboard for the current session in a local browser window, '/inspect <sessionId>' opens it pinned to a specific past session, '/inspect snapshot' re-captures the session state right now, '/inspect list' prints every captured session id in the terminal, and a small set of subcommands manages the local server that backs the dashboard, with start, stop, restart, and status. The dashboard itself runs on localhost, by default on port 5462, and the current session id is carried in the URL query string so a refresh or a copy-paste of the URL keeps the view pinned. There is also a Share button in the top bar that builds a self-contained link of the current snapshot. The snapshot is compressed and base64-encoded into the part of the URL after the hash mark, which means the recipient does not have to upload anything anywhere, the snapshot lives entirely inside the link. The recipient opens the link on a static page hosted at nikiforovall.blog/pi-inspect and sees the same tools, commands, skills, and system prompt as the sender. The README warns that, since the link includes the system prompt and the working directory, the user should not share secrets they would not paste into a chat window. The captured contents for each snapshot are: every tool with its name, description, parameter schema, and source, every slash command with its name and source, the full system prompt text, split into the system part, the user-level AGENTS.md, and the project-level AGENTS.md, and session metadata, including the working directory, the model, the session id and name, and the timestamp of capture. Snapshots are stored on disk under '~/.pi/agent/inspect/snapshots/' as JSON files named by session id.

Copy-paste prompts

Prompt 1
How do I install and run pi-inspect inside the pi coding agent?
Prompt 2
Explain the difference between /inspect, /inspect snapshot, and /inspect list.
Prompt 3
What information does a pi-inspect snapshot capture about a session?
Prompt 4
How does pi-inspect's Share link encode a session snapshot without uploading it anywhere?

Frequently asked questions

What is pi-inspect?

A local dashboard that reveals which tools, commands, skills, and system prompt text are loaded in a pi AI coding agent session.

What language is pi-inspect written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js.

How hard is pi-inspect to set up?

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

Who is pi-inspect for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.