| 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.
