packages / aphotic-pi-flow-ux
theme UI upgrades

@aphotic/pi-flow-ux

Optional UX layer for pi-flow: an always-on border-status editor, a custom startup header, the Nord theme, and a single unified /tui configuration (tui.json).

No reviews yet

Install

$ pi install npm:@aphotic/pi-flow-ux

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.10.0. 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.
  • 📁
    Files — Reads files outside your project Touches paths beyond the working directory, such as your home folder.
  • ▤
    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 message_updatesession_shutdownsession_starttool_execution_endtool_execution_starttool_execution_updateturn_endturn_start

APIs called cwd.slicecwd.startsWithgetCommandsgetCommands.filtergetCommands.filter.mapgetCommands.filter.map.sortregisterCommandregisterMessageRendererui.getAllThemesui.getAllThemes.filterui.getAllThemes.filter.mapui.getAllThemes.filter.map.sortui.notifyui.setEditorComponentui.setFooterui.setHeader

8 calls the source scan did not predict

cwd.slice · cwd.startsWith · getCommands.filter · getCommands.filter.map · getCommands.filter.map.sort · ui.getAllThemes.filter · ui.getAllThemes.filter.map · ui.getAllThemes.filter.map.sort

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.10.0 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 UI upgrades

  • glimpseui — Native micro-UI for scripts and agents — cross-platform WebView windows with bidirectional…
  • pi-powerline-footer — Powerline-style status bar for pi — model, tokens, cost, git branch and more in a configur…
  • @yevhen.b/pi-macos-theme-sync — Sync Pi's theme with macOS appearance changes.
  • @piotr-oles/pi-pr — Pi Agent extension: show the current branch's GitHub PR status (clickable #n + CI/merge/re…