Fruition Pi Workbench

Fruition's internal Pi package for Tasker Local and UnRoo-integrated delivery work.

It provides:

• a high-contrast Fruition terminal theme and branded startup shell;
• a framed prompt editor with task, branch, model, and skill context;
• Tasker handoff context through FRUITION_TASK_CONTEXT;
• task, skills, knowledge, workflow, split-editor, voice, and diagnostic commands under /fruition;
• task-aware UnRoo heartbeat reporting;
• a core Tasker workflow skill.

Install

Fruition Desktop installs and loads the package automatically for Tasker sessions. Fruition staff can also install it directly:

pi install npm:@fruition/pi-workbench

The package is intended for Fruition staff and expects Fruition's UnRoo environment and credentials for connected features. Without a Tasker context it remains usable as a branded interactive Pi setup.

Commands

/fruition task
/fruition skills           # concise inventory, matches, conflicts, warning totals
/fruition skills all       # include every loaded skill name
/fruition skills warnings  # include each validation warning and source path
/fruition voice               # record speech and insert the transcript into the prompt
/fruition open <path>      # open or add a file in the right terminal editor pane
/fruition close            # close the right editor pane
/fruition knowledge
/fruition workflow
/fruition doctor

Split editor

Interactive Pi sessions launched through Fruition's pi wrapper run in tmux. Open plans, diffs, and notes beside the live Pi terminal without replacing it:

/fruition open docs/plan.md
/fruition open /tmp/review-notes.md
/fruition close

The right pane uses nano in multibuffer mode. Ctrl+B ← returns focus to Pi, Ctrl+B → returns to the editor, Alt+< / Alt+> switch editor buffers, and Ctrl+O saves.

Voice dictation

Push-to-talk voice dictation inserts a transcript into Pi's prompt for review before sending. Fruition Desktop owns the microphone and transcription — no platform-specific audio tools are needed.

/fruition voice
Ctrl+Alt+V

The recording window appears with a timer. Press Enter or click Stop to transcribe; press Escape or click Cancel to discard. The transcript is appended to the current prompt text and never auto-submits.

Requires Fruition Desktop 3.5.0 or newer. If Desktop is not running, /fruition voice shows a clear message and leaves the prompt untouched.

Development

From the UnRoo repository:

pi --no-extensions -e ./packages/fruition-pi-workbench
npm pack ./packages/fruition-pi-workbench --dry-run