pi-stuff

Adaptable capabilities for Pi

Pi stays small.

Capabilities arrive
when needed.

Explore on GitHub See all packages

01 / Premise

A capable agent doesn’t need everything loaded. It needs the right thing available.

pi-stuff is a modular layer around Pi: persistent work without a bloated core, tools found on demand, claims backed by evidence, and memory that remains reviewable.

02 / Durable runtime

Work can outlive
the conversation.

Start processes and services through a local daemon. Read bounded output, wait for completion, stop process groups safely, and recover task records after Pi exits. A public v2 event-bus adapter also connects Pi subagents without pretending their process-local identity is durable.

001
task_startnode server.js
running
002
session_shutdownPi disconnects
detached
still running
003
task_outputresume at cursor 1840
recovered

03 / Tool discoverability

Not more tools
in context.
Better access.

tool catalog09 available
verify changed code↵
  • 01
    verification_runRun project checks and retain evidence
    96%
  • 02
    simplify_candidatesFind excess in changed code
    84%
  • 03
    cicd_statusInspect GitHub checks and workflows
    71%

Search metadata first. Activate explicitly. Keep the working context focused.

04 / Evidence

“Done” is not
a feeling.

Verification turns a claim into a retained, fresh, redacted record.

VERIFICATION / 7F2APASS
command
npm run verify
exit
0
duration
12.84s
freshness
just now
evidence retained

05 / Reviewed memory

Remember with
receipts.

Cross-session memory is proposed, not silently absorbed. Every record carries provenance, confidence, lifecycle, and optional expiry. You decide what becomes active.

  1. 01candidate
  2. 02review
  3. 03active

06 / The ecosystem

Choose your
capabilities.

Install one. Combine several. Pi remains legible while the system grows around it.

01supervisorDurable local tasks & services 02task protocolVersioned lifecycle contracts 03verificationFresh, retained evidence 04tool catalogDeferred tool discovery 05memoryReviewed cross-session context 06simplifyLess code after the work 07diffBrowser-native code review 08cicd statusGitHub pipeline inspection 09mermaidDiagrams inside the terminal

07 / Start small

Add only
what the work
requires.

pi install npm:@geminixiang/pi-simplify
Read the documentation