pi-ui

keyboard-first minimal gui for pi

features

• background sessions
• git review with commit history and inline comments
• markdown, syntax highlighting, and rich diffs
• file attachments with image previews

built with

• datastar
• kita-jsx
• pierre-diffs
• basecoat

try

requires bun 1.4+

bunx @hyperpuncher/pi-ui

install

quick install

the quick installers start pi-ui in the background and at login

linux and macos

curl -fsSL https://pi-ui.app/install | sh

windows

irm https://pi-ui.app/install.ps1 | iex

open http://127.0.0.1:31415 in your browser

package managers

bun

requires bun 1.4+

bun i -g @hyperpuncher/pi-ui

arch

paru -S pi-ui-bin

homebrew

brew install hyperpuncher/tap/pi-ui

package-manager installs must be started with pi-ui or configured as a background service below

background service

start pi-ui now and at login:

pi-ui service install

stop pi-ui and remove the service:

pi-ui service uninstall

homebrew

homebrew manages the service separately:

brew services start pi-ui
brew services stop pi-ui

development

requires bun 1.4+

bun ci
bun run server

configuration

pi-ui stores its configuration in:

• linux: ~/.config/pi-ui/config.json
• macos: ~/.config/pi-ui/config.json
• windows: %APPDATA%\pi-ui\config.json

all options with their defaults:

{
	"$schema": "https://pi-ui.app/config.schema.json",
	"autoTitle": {
		"enabled": true,
		"models": [
			"openai-codex/gpt-5.6-luna:minimal",
			"opencode-go/deepseek-v4-flash:off"
		],
		"prompt": "use lowercase"
	},
	"codeTheme": {
		"dark": "pierre-dark-soft",
		"light": "pierre-light"
	},
	"fonts": {
		"mono": "system",
		"sans": "system"
	},
	"gitView": {
		"changesRatio": 0.5,
		"gitPaneRatio": 0.5,
		"layout": "split",
		"mode": "all",
		"reviewSidebarWidth": 272,
		"tab": "git",
		"wrap": true
	},
	"keybindHints": true,
	"minimalMode": false,
	"toolOutputHidden": false
}

keybinds

key	action
ctrl/⌘ k	command palette
ctrl/⌘ b	toggle session sidebar
ctrl/⌘ 1–9	switch session
ctrl/⌘ o	new session
ctrl/⌘ alt o	temporary chat
ctrl/⌘ r	session picker
ctrl/⌘ /	workspace picker
ctrl/⌘ g	toggle workspace
alt p	focus prompt
alt c	focus conversation
alt f	focus workspace files
alt g	focus git changes
alt e	focus file or diff
alt s	focus sessions
alt m	toggle minimal mode
alt o	toggle tool output
ctrl/⌘ l	model picker
ctrl/⌘ p	cycle favorite model
ctrl/⌘ shift p	cycle favorite model back
alt t	cycle thinking level
alt shift t	cycle thinking back
ctrl/⌘ alt t	toggle thinking blocks
/	slash commands
@	file picker
alt enter	queue follow-up
alt ↑	restore queued text
j / k or ↑ / ↓	move or scroll focused pane
gg / G	top / bottom

license

mit