pi-umbra

Every small thing pi does not build in, in one install: seven themes and the chrome around them, the input bar, a shimmer through the working indicator, ask, copy-chat, preview, help, and parallel pi branches (read-only, or editing in their own git worktr

Packages

Package details

extensionskilltheme

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

npm repo home report

$ pi install npm:pi-umbra

Package: pi-umbra
Version: 0.5.0
Published: Oct 4, 2026
Downloads: 1,145/mo · 576/wk
Author: grknbyk
License: MIT
Types: extension, skill, theme
Size: 15.2 MB
Dependencies: 8 dependencies · 3 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/grknbyk/pi-umbra/main/assets/carousel.webp",
  "skills": [
    "./node_modules/pi-umbra-subagents/extensions/umbra-subagents/skills"
  ],
  "themes": [
    "./node_modules/pi-umbra-theme/themes"
  ],
  "extensions": [
    "./node_modules/pi-umbra-theme/extensions",
    "./node_modules/pi-umbra-ask/extensions",
    "./node_modules/pi-umbra-copy-chat/extensions",
    "./node_modules/pi-umbra-help/extensions",
    "./node_modules/pi-umbra-inputbar/extensions",
    "./node_modules/pi-umbra-preview/extensions",
    "./node_modules/pi-umbra-shimmer/extensions",
    "./node_modules/pi-umbra-subagents/extensions/umbra-subagents.ts",
    "./node_modules/pi-umbra-subagents/extensions/umbra-loop.ts"
  ]
}

Security note

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

README

pi-umbra

Every pi-umbra package in one install: seven dark themes, tool calls drawn as cards, a status footer, an input bar with the session name, a working line that names the running tool, parallel pi branches (read-only, or editing in their own git worktree) with a live agent tree, and the /umb-* commands.

A one-minute tour: tool cards and diffs, the working line, a question from the model, parallel branches, the card settings and the seven themes

pi install npm:pi-umbra

The eight packages ship bundled inside this one tarball. Two of them patch pi's bundle, so run the two scripts once now and again after every pi update, then restart pi:

node ~/.pi/agent/npm/node_modules/pi-umbra/node_modules/pi-umbra-shimmer/patch.mjs
node ~/.pi/agent/npm/node_modules/pi-umbra/node_modules/pi-umbra-subagents/patch.mjs

Coming from 0.4 or older: pi-umbra-skill-matcher is gone, because pi completes and runs /skill:name itself since 1.0. Its bundle patch stays in pi until pi is reinstalled, and until then a / typed mid-sentence opens file completion. Reinstall pi to drop it: npm install -g @earendil-works/pi-coding-agent.

Package	What it adds
pi-umbra-theme	seven themes, terminal background, footer, gutter, tool cards, image viewer, working line
pi-umbra-inputbar	`❯` prompt, session name on the input border, `/umb-color`
pi-umbra-ask	a tool the model calls to ask you a question and wait
pi-umbra-shimmer	a wave of colour through the working line, `/umb-shimmer`
pi-umbra-copy-chat	`/umb-copy-chat`, the session on the clipboard
pi-umbra-preview	`/umb-preview`, render a document in the browser
pi-umbra-help	`/umb-help` and `/umb-doctor`
pi-umbra-subagents	parallel pi branches, read-only or in their own git worktree, with a live agent tree, `/umb-fan`, `/umb-loop`

Full documentation: github.com/grknbyk/pi-umbra.

MIT.