configure-amp-themes

name	configure-amp-themes
description	Use when configuring, installing, updating, troubleshooting, or switching themes for the amp-themes Pi UI package, especially amp-dark, amp-light, or conflicts with pi-tool-display.

Configure amp-themes

Overview

amp-themes is a Pi UI package. It provides Amp-style editor chrome, self-authored compact tool display for Pi's built-in tools, and theme files amp-dark and amp-light that auto-switch to follow device appearance.

Goal: make the package load once, avoid renderer conflicts, and set the intended theme.

Quick setup

Install the package:

pi install npm:amp-themes

Set the theme in ~/.pi/agent/settings.json:

{
  "theme": "amp-dark"
}

Or use Pi's interactive settings:

/settings → Theme → amp-dark

Conflict cleanup

amp-themes registers its own renderers for Pi's built-in tools (read, grep, find, ls, bash, edit, write). Do not load standalone npm:pi-tool-display at the same time: it overrides the same built-in tools, so the two would double-register and conflict (last load wins).

Check packages:

pi list

If standalone pi-tool-display is present, remove it:

pi remove npm:pi-tool-display

If an old local package appears in settings, remove it from ~/.pi/agent/settings.json:

packages/amp-agent-ui

Keep this package entry:

npm:amp-themes

Update

pi update npm:amp-themes

Verify

Run a smoke test:

pi -p "Reply with ok"

For interactive UI verification, start Pi and check startup resources show:

[Extensions]
  amp-themes:amp-editor.ts
  amp-themes:amp-tool-display.ts

[Themes]
  amp-dark
  amp-light

The editor should show a rounded bottom input area with context usage, model id, thinking level, cwd, and branch.

Common issues

Symptom	Likely cause	Fix
Tool renderer conflict	npm:pi-tool-display loaded separately double-registers the built-in tools	pi remove npm:pi-tool-display
Theme not found	Old theme name or package not installed	Use amp-dark or amp-light; run pi install npm:amp-themes
Editor chrome not showing	Extension disabled or package filtered	Check pi list and ~/.pi/agent/settings.json package filters
Old amp-agent theme missing	Theme was renamed before general use	Set theme to amp-dark or amp-light

Do not

• Do not install standalone npm:pi-tool-display together with amp-themes.
• Do not keep old packages/amp-agent-ui in settings.
• Do not set theme to amp-agent; use amp-dark or amp-light.