huang-sh /PiX

A non-linear AI agent workbench — session is a tree: branch anytime, and context follows the branch

★ 228⑂ 21👁 1▤ 34
TypeScriptCreated 2026-09-04
+0
Daily
+0
Weekly
+34
Monthly
228
stars
21
forks
1
watchers
–
prs
–
issues
34
releases

README

PiX

A non-linear AI agent workbench — sessions are graphs: branch anytime, and context follows the branch

English · 中文 · 日本語

---


  


A PiX session is not a line — it is a graph that keeps growing: every conversation turn is a node, and any node can sprout a new branch at any time.

 Non-linear sessions

A traditional AI chat is a single timeline: to change direction you either start over or keep piling questions onto the same thread until the context becomes a mess.

PiX organizes a session as a graph that grows left to right:

- Every turn (your prompt plus the assistant's reply and tool calls) is a node on the graph.
- Several directions can live on the same graph — switch to another branch at any time and keep going, without interference.
- When a path works out, keep going deeper; dead ends stay on the graph, and you can always come back and try another route.
- Sessions are real Pi sessions — no new format — so they remain usable outside PiX.

 Branch anytime

Branching is an everyday action in PiX, not something you have to plan ahead:

- Fork from any user message: unhappy with an answer? Fork a new branch from that turn with a different prompt or approach — the original branch stays untouched.
- Continue from a turn: select any earlier node on the graph and pick up the conversation from that moment.
- Clone the active branch: clone the current branch as a save point and experiment freely. Every branch stays visible on the graph, ready to switch back to at any time.

 Context follows the branch

Switching branches never means re-setting up context — context is part of the branch:

- The branch chat panel shows only the messages of the active branch. Switch to another branch and the chat switches with it.
- A single click highlights a node on the graph without touching any panel (graph commands such as /fork act on the highlighted node); a double-click aligns the primary chat panel to that node.
- Double-click a node on the graph to open its conversation in the primary chat panel. Ctrl+double-click (or the right-click menu's "Open in chat panel") pins that branch to a second or third side-by-side chat column — up to 3 columns at once for comparing branches. Each branch keeps a single panel: opening another node of an already-pinned branch retargets that column. Every column scrolls and replies independently. Replying from a pinned column grows that branch in place: the column follows the newly created node, and the primary column keeps the current selection. Closing the last pinned column — or the next start — restores the chat width.
- The branch context panel follows the selected node and shows how that turn went: thinking, tool calls, duration, and step count — and you can reply to the selected node right from there.


  


 Built-in extensions

PiX embeds Pi 1.5, including its MCP, Codemode and tool-search extensions. Existing Pi v3 JSONL sessions keep working. Tool rows show elapsed time while running and saved durations after co

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON