Pi Coding Agent
Visual VS Code UI for Pi — your CLI, config, models, and sessions.
English ·
简体中文
Pi Coding Agent UI is a VS Code extension that drives Mario Zechner’s open-source Pi coding agent from a native sidebar: conversation, tool cards, model picker, thinking levels, session tree, shell shortcuts, editor context chips, and more.
It does not replace Pi. It launches your installed pi CLI and reuses ~/.pi/agent (models, sessions, skills, settings).
Fork notice
This repository is a fork and rebrand of:
- Marketplace / sidebar product name: Pi Coding Agent UI (sidebar label: Pi)
- Extension ID:
yesho.pi-coding-agent-vscode
- Settings prefix:
piAgent.*
- Commands:
Pi Coding Agent: … / piAgent.*
Because FrostPi is AGPL-3.0, this fork remains AGPL-3.0. Derivative releases must keep source available and preserve attribution. See LICENSE and THIRD_PARTY_NOTICES.md.
The historical Frost UI README is kept as README.frost-ui.md for reference.
Prerequisites
Pi CLI on PATH (or set piAgent.pi.executable):
npm install -g @earendil-works/pi-coding-agent
pi --version
Models / providers configured with Pi (/login inside Pi, or your existing ~/.pi setup).
VS Code 1.99+, trusted workspace.
Install
From Marketplace (after publish)
- Install Pi Coding Agent UI (
yesho.pi-coding-agent-vscode)
- Open the Pi icon in the Activity Bar
- Start or resume a session
From VSIX (local)
code --install-extension "artifacts/Pi Coding Agent-1.0.0.vsix"
Reload the window after install.
Build from source
pnpm install
pnpm package:vsix
code --install-extension "artifacts/Pi Coding Agent-<version>.vsix"
Highlights
- Sidebar chat for Pi (steer / follow-up, permission modes)
- Model + thinking-level pickers (LobeHub-style vendor icons)
- Session list, resume, tree branch / switch, auto-rename
- Composer:
@ path attach, + QuickPick (Material Icon Theme icons when installed), ! / !! shell
- Editor context chip: active (
×) vs inactive ghost; Esc to detach; Clear wipes all chips
- Markdown, Mermaid, tool cards, diffs, images, save-as-image
- Copilot Chat LM provider optional (
piAgent.persistSessions)
Settings
All settings live under piAgent.* (was frostui.* in pre-1.0 Frost UI builds). Open Settings and search Pi Coding Agent or piAgent.
| Setting |
Default |
Meaning |
piAgent.pi.executable |
"" |
Path to pi if not on PATH |
piAgent.session.autoRename |
true |
Name sessions from the first prompt |
piAgent.agent.permissionMode |
ask |
ask / autoConfirm / restricted |
piAgent.composer.streamingBehavior |
followUp |
steer or followUp |
Marketplace publish (maintainers)
# 1) Azure DevOps PAT with Marketplace (Publish) scope
# 2) Publisher must exist: yesho
export VSCE_PAT=<your-pat>
pnpm publish:marketplace
Or package only:
pnpm package:vsix
GitHub
Source: https://github.com/YeSho-cpp/pi-coding-agent
git remote add origin https://github.com/YeSho-cpp/pi-coding-agent.git
git push -u origin master
License
AGPL-3.0 — see LICENSE. Upstream FrostPi remains AGPL-3.0; this distribution must stay AGPL-3.0-compatible and credit upstream.
Credits
