Pi Atelier plugin
An extension for the Pi agent: a status rail and sidebar with model, context, usage, tasks and subagent costs
- 386 ★ on the repository
- Last commit
Minimal access
Why this level
- The extension only displays session data, reads git without writing and makes no network calls.
Install
Manual install
pi install npm:pi-atelierThe extension uses the running Pi host's core packages and pulls no second copy; Pi itself is updated separately.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The extension only displays session data, reads git without writing and makes no network calls.
This is third-party code. Review the repository files before installing.
What it does
Pi Atelier adds a compact status rail and a live sidebar to the Pi terminal interface. The rail shows the model, thinking level, context fill, tokens, cost and session details. The sidebar shows agent and tool activity, a task list, response timing and read-only git status. `/atelier usage` opens a cost graph for each subagent from pi-subagents with a coloured legend and per-reply costs. With a local model through llama.cpp, a temporary panel shows how much of a long prompt the model has read, how fast and how long until the first token. Settings change through `/atelier` or the F6 key: three rail presets, a set of segments and panels, Nerd Font icons, model and tool selection. Other extensions can add their own blocks to the sidebar.
Who it is for. Users of the Pi coding agent who run subagents or local models and want usage and progress in view without extra windows.
Good fit when
- Subagents spend money in parallel, and you need each one's cost separately.
- A local model stays silent on a long prompt, and it is unclear whether it hangs or reads.
- Session context fills up unnoticed, and you want its level always in view.
- You need the agent's task list and a notification when a reply completes on macOS or Windows.
Not a fit when
- You work in Claude Code, Codex or Cursor: the extension is built only for Pi.
- Pi runs non-interactively, for example in scripts.
- Another extension with its own footer is installed and you do not want to replace it.
Example request
/atelier usageLimitations
You need Pi 0.84.0 and Node.js 22.19.0 or newer, and only the interactive text UI is supported. Pi shows one footer at a time, so on conflict with another extension the Atelier footer is turned off and only the sidebar stays. Prompt reading progress needs Pi 0.99 and is requested only from allow-listed `openai-completions` endpoints, `llama.cpp` by default. The sidebar hides in terminals narrower than 92 columns, and without a Nerd Font the plain text icon mode is needed.
How to disable. Run `/atelier disable` or remove the package through Pi's package manager. Settings live in `~/.pi/agent/pi-atelier.json`.
FAQ
How do I install Pi Atelier?
Run `pi install npm:pi-atelier` and start Pi. The control center opens with `/atelier` or the F6 key.
Does the extension send data anywhere?
No. There is no telemetry or external requests, and it stores no prompts, replies or keys. Git is read-only and only in trusted projects.
Why is there no prompt reading progress?
It appears only for allow-listed providers in `prefillProviders` and only if the server reports progress. For pi-llama-swap set its instance id instead of `llama.cpp`.
How do I combine it with another status line extension?
Turn off the Atelier footer in settings or set `"showFooter": false`. The sidebar keeps working.
Where are project settings stored?
In `<project>/.pi/pi-atelier.json`, read only for trusted projects. User settings live in `~/.pi/agent/pi-atelier.json`.
Discussion
No questions or reviews yet.
Related
PluginsAn extension for the Pi agent: a Go web interface for sessions from a phone or laptop, with remote access over Tailscale
Agent Standup shows Claude Code, Codex and Mistral Vibe sessions as a live team call: who works, who waits.
A desktop pet and menu-bar monitor that shows which coding agent is working, done or waiting for your input
A Herdr plugin shows model, context and remaining quota for each agent in the sidebar, grouped by workspace.
The /myoffice command opens a browser office showing what every agent on your machine is doing: thinking, waiting for you or done.
htop for AI costs: a terminal dashboard shows tokens and spending across 11 providers and 8 coding agents in real time.
README in short
The README gives a one-command install, requirements and a feature table. Then it covers sidebar modes, prompt reading progress, rail presets, settings files and privacy rules.