repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

extensions/split-fork/README.md

Raw

split-fork

Fork Pi into a Ghostty split.

Install / load

Loaded through the root pi-ext package. See root README.

Commands / tools / settings

Behavior

/split-fork copies the current session branch into a new session file and opens a right-hand Ghostty split running Pi on that fork. If a prompt is provided, the new Pi process receives it as startup input.

Requirements:

On non-macOS hosts the command exits with a warning. On macOS the extension warns at session start when osascript is missing.

Markdown source
# split-fork

Fork Pi into a Ghostty split.

## Install / load

Loaded through the root `pi-ext` package.
See [root README](../../README.md).

## Commands / tools / settings

- Commands:
  - `/split-fork [prompt]`
- Tools:
  none
- Hooks:
  - `session_start`
- Settings:
  none

## Behavior

`/split-fork` copies the current session branch into a new session file and opens a right-hand Ghostty split running Pi on that fork.
If a prompt is provided, the new Pi process receives it as startup input.

Requirements:

- macOS
- Ghostty
- `osascript`

On non-macOS hosts the command exits with a warning.
On macOS the extension warns at session start when `osascript` is missing.