packages / pi-branch-out
extension Session utilities

pi-branch-out

Fork the current Pi session into a split terminal pane or new tab with rotating layout policies, and with optional model and message queuing, and support for cmux, tmux, iTerm2, Terminal.app, Ghostty, and Orca.

No reviews yet

Install

$ pi install npm:pi-branch-out

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.1.5. 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.
  • ⌨
    Keystrokes — Reads raw terminal input Hooks ui.onTerminalInput, so it sees what you type. Legitimate for shortcut handling; the same access a keylogger needs.
  • ▤
    UI — Draws its own interface Renders widgets, footers, dialogs or full-screen views.

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_before_forksession_before_switchsession_before_treesession_shutdownsession_startsession_tree

APIs called registerCommandregisterFlagsessionManager.getBranchsessionManager.getLeafIdsessionManager.getSessionFilesessionManager.getSessionFile.slicesessionManager.getSessionFile.startsWithwaitForIdle

8 calls the source scan did not predict

on("session_before_fork") · on("session_before_switch") · on("session_before_tree") · on("session_shutdown") · on("session_tree") · sessionManager.getSessionFile.slice · sessionManager.getSessionFile.startsWith · waitForIdle

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.1.5 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