@tryinget/pi-peer-messaging
Stable core contract for same-machine peer-session messaging in pi
Install
pi install npm:@tryinget/pi-peer-messaging
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.2.1.
This describes access, not safety — you decide whether it's appropriate for what
the package claims to do.
- Behavior — Changes how the agent thinks Modifies the system prompt, injects messages, or rewrites conversation context.
- Commands — Runs shell commands Spawns processes on your machine.
- Files — Reads files outside your project Touches paths beyond the working directory, such as your home folder.
- Network — Talks to the internet Makes outbound network requests. Check the destinations are ones you expect.
- New tools — Adds model-callable tools Gives the agent new abilities. Additive and visible, unlike an override.
What it actually did when run
observedLoaded 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.
Tools registered intercom
Events subscribed session_shutdownsession_start
APIs called model.id.trimregisterToolsessionManager.getCwdsessionManager.getCwd.toJSONsessionManager.getSessionIdsessionManager.getSessionId.trimsessionManager.getSessionId.trim.replacesessionManager.getSessionId.trim.replace.toJSONsessionManager.getSessionId.trim.startsWithsessionManager.getSessionNamesessionManager.getSessionName.trim
7 calls the source scan did not predict
model.id.trim · sessionManager.getCwd.toJSON · sessionManager.getSessionId.trim · sessionManager.getSessionId.trim.replace · sessionManager.getSessionId.trim.replace.toJSON · sessionManager.getSessionId.trim.startsWith · sessionManager.getSessionName.trim
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.2.1 on 2026-08-02.
Registration-time behaviour under default settings; other configurations may differ.
Reviews
0 publishedSign in with GitHub to write a review, reply, or vote.
No reviews yet — be the first.
More in Session utilities
- @carter-mcalister/pi-skillpacks — Session-scoped skill pack loader for Pi
- pi-tmux-branch — Pi extension for branching the current session into a new tmux pane.
- pi-unshare — Revoke pi coding-agent session shares: find and delete the secret gists created by /share,…
- pi-session-bookmarks — Bookmark Pi sessions and jump back in from any repo.