omp packages

@mblarsen/pi-fux0.1.2

Fork Pi sessions into tmux panes and merge them back.

GitHub Actions Published 9 days ago MIT ~282 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

fux

Adds a leaf node to the session tree, forks Pi into a parallel pane, then grafts the fork back at the marked leaf — like a git branch and merge, but for your conversation history.

Provides the /fux slash command and the fux_fork LLM tool. Merge and delete remain slash-command-only for safety.

Demo

demo

Install

pi install npm:@mblarsen/pi-fux

Usage

Command Description
/fux Fork current session into a new tmux pane
/fux prompt <text> Fork with an initial prompt sent to the child
/fux merge [--dry-run] [--yes] [--keep|--delete] Merge child fork back into parent
/fux delete [--yes] Delete the child fork and close the pane
/fux toggle Show or hide the fux guidance widget

LLM tool: fux_fork — available to the agent to fork sessions programmatically.

Workflow

  1. Run /fux (or /fux prompt <text>) from the parent session.
  2. A new tmux pane opens with a branched Pi session.
  3. Work in the fork. Both sessions show a guidance widget with the restart command.
  4. When done, run /fux merge --dry-run in the fork to preview, then /fux merge to confirm.
  5. Restart the parent session with the printed command (e.g. pi --resume <path>).

The parent session file is modified externally during merge — you must restart pi to see the merged history.