gitwtfhub

wtf is pi-manager?

scp3500/pi-manager — explained in plain English

Analysis updated 2026-05-18

43JavaScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A local web dashboard for managing Pi Coding Agent: models, sub-agents, sessions, usage, and optional vision recognition, all from your browser.

Mindmap

mindmap
  root((repo))
    What it does
      Web dashboard
      For Pi Coding Agent
      Local only
    Tech stack
      Node.js
      JavaScript
      Zero dependencies
    Use cases
      Track usage cost
      Edit sub agents
      Manage sessions
    Audience
      Developers
      CLI agent users

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

Why would anyone build with this?

REASON 1

Check how much your AI coding sessions have cost today without digging through log files.

REASON 2

Edit sub-agent configuration files through a web form instead of hand-editing markdown.

REASON 3

Clean up old or bloated agent sessions and restore them later if needed.

REASON 4

See at a glance whether the coding agent is currently working, thinking, or idle.

What's in the stack?

JavaScriptNode.js

How it stacks up

scp3500/pi-managerearthtojake/implicit.jsjavlonbek1233/amaliy-ish
Stars434343
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasyeasy
Complexity3/53/52/5
Audiencedeveloperdevelopervibe coder

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Pi Coding Agent already configured, plus Node.js 18 or later.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Pi Manager is a local web dashboard for people who use Pi Coding Agent, a command line coding assistant. Instead of digging through config files and terminal logs, you open a page at localhost:3001 and get an overview of everything the agent is doing. The dashboard shows your default AI model, how much you have spent today, cache hit rates, and how large your saved sessions have grown, all in one screen. A live status view infers what the agent is currently doing, working, thinking, or finished, by reading its session logs and checking running processes. You can manage the AI model providers you have configured, pull models from a remote source, and set defaults. Sub-agents, which are specialized helper configurations stored as markdown files, can be edited directly from the interface, along with their tool permissions and workflow rules. Other sections let you search and clean up old sessions with a recycle bin for recovery, track token usage and cost trends over time, and browse installed plugins with a whitelist for adding new ones. You can map a local folder as a workspace so the agent can read memory and knowledge files from it. There is also a built in tutorial section with setup instructions and example agents, plus a sidebar chat assistant that asks for confirmation before making any changes. Pi Manager optionally integrates with OpenVL, a separate vision recognition tool made by the same author, which can be installed with one click from the tutorial page if you want the agent to read images. The project has zero production dependencies beyond Node.js version 18 or later, and ships as static files with no build step. It is designed to run locally only. The README warns against exposing the port to the public internet, and notes that exported configuration files have API keys removed automatically. Any settings the dashboard writes are saved with automatic backups of the previous version. It is released under the MIT license.

Yoink these prompts

Prompt 1
Help me set up Pi Manager to monitor my Pi Coding Agent sessions on localhost.
Prompt 2
Walk me through connecting a new model provider inside Pi Manager.
Prompt 3
Explain how Pi Manager infers whether my agent is working or idle from session logs.
Prompt 4
Show me how to map a local folder as a workspace in Pi Manager.

Frequently asked questions

wtf is pi-manager?

A local web dashboard for managing Pi Coding Agent: models, sub-agents, sessions, usage, and optional vision recognition, all from your browser.

What language is pi-manager written in?

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

What license does pi-manager use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is pi-manager to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pi-manager for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.