pi-message-frames

Presentation-only colored frames around Pi chat messages (user, assistant, tools, bash, summaries), with passive collapse, click-to-expand and timestamps. Fork of RamonsDka's message-frames (MIT).

Packages

Package details

extension

Install pi-message-frames from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-message-frames
Package
pi-message-frames
Version
0.5.1
Published
Nov 21, 2026
Downloads
587/mo · 587/wk
Author
wilberc
License
MIT
Types
extension
Size
25.9 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-message-frames

Colored frames around every Pi chat message, with collapse, click-to-expand and timestamps. A presentation-only Pi and Gentle Shell extension.

What it does

Each message kind gets its own framed card with a titled rail and a subtle background: ❯ user, ✦ assistant, ⚙ tool, $ bash, ⟳ subagent, ≡ compaction/branch summaries, ◇ skills and custom entries. Titles carry the start time, end time and duration of each frame:

✦ Assistant · ▶ 14:03 · ⏹ 14:05 · ⏱ 1.5s

Tool and bash output collapses to its first lines; a left click expands it.

What it solves

  • A long chat is a wall of text. Frames make it obvious where a message starts and who wrote it.
  • Tool output buries the conversation. Passive collapse keeps tool and bash frames to three lines until you click them open.
  • "When did this run, and how long did it take?" Every frame shows its clock and its own duration, frozen when its work ends; failures show ✗.

It changes presentation only: no tools, model hooks, session access or execution overrides. /message-frames off restores the native look at once.

Install

# Gentle Shell
gentle-shell install npm:pi-message-frames

# Pi
pi install npm:pi-message-frames

Then /reload inside the session. To try unreleased changes from main: pi install git:github.com/WilberC/pi-message-frames. Built against Pi 1.5.0 / the Gentle Pi main build; checkout install and version notes: docs/development.md.

Quick reference

Command Effect
/message-frames on|off install or remove the frames immediately
/message-frames status current state and every toggle
/message-frames timer on|off show or hide the per-frame duration
/message-frames start on|off show or hide the start time
/message-frames end on|off show or hide the end time

Documentation

I want to… Read
Learn every command, collapse and timestamp rule docs/usage.md
Understand what gets wrapped, and the known limits docs/architecture.md
Run the tests or work on the code docs/development.md

Credits and license

A fork of message-frames by RamonsDka (gs3-sidebar, MIT). The framing core — render wrappers, ANSI background compositing, OSC 133 zone preservation, unframing of existing chrome and the ownership/restore protocol — is his original work. This fork adds passive collapse, click-to-expand, render-cycle metadata, timestamp/duration titles and the Pi package. MIT, see LICENSE for the dual copyright notice; design references are listed in docs/architecture.md.