@jpodivin/pi-fireplace

A cozy fireplace for pi coding agent — animated flames, toggleable smoke

Packages

Package details

extension

Install @jpodivin/pi-fireplace from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@jpodivin/pi-fireplace
Package
@jpodivin/pi-fireplace
Version
0.2.1
Published
Jul 18, 2026
Downloads
780/mo · 34/wk
Author
jpodivin
License
MIT
Types
extension
Size
17.1 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

@jpodivin/pi-fireplace 🔥

A cozy fireplace for the pi coding agent - animated flames with toggleable smoke, right in your terminal.

This is mostly an exercise in making installable package for my coding agent. All credit for the idea should go to the creator of the original emacs-fireplace, Johan Sivertsen.

Features

  • Animated flames — Procedural flickering flame animation with orange/dark-orange fire
  • Toggleable smoke — Press S to toggle smoke particles on/off
  • Boxed firebox display — Bordered firebox with colorful flame blocks, footer with keybinding hints
  • Lightweight — Runs entirely in the terminal, no external dependencies

Installation

From npm

pi install npm:@jpodivin/pi-fireplace

From local path (development)

pi install /absolute/path/to/pi-fireplace
pi install .  # when cwd is the package directory

Then type /fireplace in the editor.

Usage

  1. Start pi in interactive mode
  2. Type /fireplace and press Enter
  3. Enjoy the cozy fireplace animation!

Keybindings

Key Action
S Toggle smoke on/off
Q Quit fireplace
Esc Exit fireplace

Development

To test locally:

pi -e ./extensions/index.ts

Then in the pi editor, type /fireplace.

To run the structural flame tests:

pnpm test
# or directly:
pnpm tsx --test test.ts

License

MIT