pi-extension-change-background

A Pi extension for changing the Windows Terminal background image

Packages

Package details

extension

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

npm repo home report

$ pi install npm:pi-extension-change-background

Package: pi-extension-change-background
Version: 1.0.0
Published: Aug 15, 2026
Downloads: 124/mo · 9/wk
Author: izzathilmi98
License: MIT
Types: extension
Size: 235.5 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ],
  "image": "https://raw.githubusercontent.com/izzathilmi/pi-extension-change-background/main/assets/screenshot.png"
}

Security note

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

README

pi-extension-change-background

A Pi extension that adds /change-background for Windows Terminal.

Features

Set a background image from an absolute or working-directory-relative path.
Disable the background with off or none.
Preserve other Windows Terminal settings while updating profiles.defaults.
Use readable defaults: 25% opacity, centered, and uniformToFill scaling.

Requirements

Pi
Windows Terminal on Windows.

Install

pi install git:github.com/izzathilmi/pi-extension-change-background

After installation, reload Pi with /reload.

Usage

/change-background C:\\Users\\you\\Pictures\\background.jpg
/change-background .\\images\\background.png
/change-background off

Run /change-background without an argument to display the current image and usage.

Changes are written to the Windows Terminal settings.json file. Open a new Windows Terminal tab to apply them.

Platform scope

The slash command is available in Pi. The setting it changes belongs to Windows Terminal, so the selected background is also visible to other CLI programs running inside Windows Terminal, including Claude Code, Codex CLI, PowerShell, and WSL. It does not configure unrelated terminal applications such as the VS Code integrated terminal.

Security note

Pi extensions run with full system permissions. Review the source before installing. This extension only reads and updates the detected Windows Terminal settings file and validates that the requested image path points to a regular file.

License

MIT