@hyperpuncher/pi-ui 0.38.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hyperpuncher
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,161 @@
+# pi-ui
+
+keyboard-first minimal gui for [`pi`](https://pi.dev).
+
+<div>
+	<picture>
+		<source
+			srcset=".github/assets/screenshot-dark.png"
+			media="(prefers-color-scheme: dark)"
+		>
+		<source
+			srcset=".github/assets/screenshot-light.png"
+			media="(prefers-color-scheme: light)"
+		>
+		<img src=".github/assets/screenshot-dark.png" alt="pi-ui screenshot">
+	</picture>
+</div>
+
+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`](https://data-star.dev/)
+- [`kita-jsx`](https://github.com/kitajs/html)
+- [`pierre-diffs`](https://diffs.com/)
+- [`basecoat`](https://basecoatui.com/)
+
+## install
+
+after installing, open [http://127.0.0.1:31415](http://127.0.0.1:31415) in your browser.
+
+### run without installing
+
+requires bun 1.4 or newer
+
+```sh
+bunx @hyperpuncher/pi-ui
+```
+
+### quick install (linux / mac)
+
+```sh
+curl -fsSL https://pi-ui.app/install | sh
+```
+
+### arch
+
+```sh
+paru -S pi-ui-bin
+pi-ui autostart enable
+```
+
+### mac
+
+```sh
+brew install hyperpuncher/tap/pi-ui
+brew services start pi-ui
+```
+
+### windows
+
+```powershell
+irm https://pi-ui.app/install.ps1 | iex
+```
+
+the windows installer starts pi-ui at login.
+
+## development
+
+requires bun 1.4 or newer
+
+```sh
+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:
+
+```json
+{
+	"$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                      |
+| ---------------------------------------------------------- | --------------------------- |
+| <kbd>ctrl/⌘</kbd> <kbd>k</kbd>                             | command palette             |
+| <kbd>ctrl/⌘</kbd> <kbd>b</kbd>                             | toggle session sidebar      |
+| <kbd>ctrl/⌘</kbd> <kbd>1–9</kbd>                           | switch session              |
+| <kbd>ctrl/⌘</kbd> <kbd>o</kbd>                             | new session                 |
+| <kbd>ctrl/⌘</kbd> <kbd>alt</kbd> <kbd>o</kbd>              | temporary chat              |
+| <kbd>ctrl/⌘</kbd> <kbd>r</kbd>                             | session picker              |
+| <kbd>ctrl/⌘</kbd> <kbd>/</kbd>                             | workspace picker            |
+| <kbd>ctrl/⌘</kbd> <kbd>g</kbd>                             | toggle workspace            |
+| <kbd>alt</kbd> <kbd>p</kbd>                                | focus prompt                |
+| <kbd>alt</kbd> <kbd>c</kbd>                                | focus conversation          |
+| <kbd>alt</kbd> <kbd>f</kbd>                                | focus workspace files       |
+| <kbd>alt</kbd> <kbd>g</kbd>                                | focus git changes           |
+| <kbd>alt</kbd> <kbd>e</kbd>                                | focus file or diff          |
+| <kbd>alt</kbd> <kbd>s</kbd>                                | focus sessions              |
+| <kbd>alt</kbd> <kbd>m</kbd>                                | toggle minimal mode         |
+| <kbd>alt</kbd> <kbd>o</kbd>                                | toggle tool output          |
+| <kbd>ctrl/⌘</kbd> <kbd>l</kbd>                             | model picker                |
+| <kbd>ctrl/⌘</kbd> <kbd>p</kbd>                             | cycle favorite model        |
+| <kbd>ctrl/⌘</kbd> <kbd>shift</kbd> <kbd>p</kbd>            | cycle favorite model back   |
+| <kbd>alt</kbd> <kbd>t</kbd>                                | cycle thinking level        |
+| <kbd>alt</kbd> <kbd>shift</kbd> <kbd>t</kbd>               | cycle thinking back         |
+| <kbd>ctrl/⌘</kbd> <kbd>alt</kbd> <kbd>t</kbd>              | toggle thinking blocks      |
+| <kbd>/</kbd>                                               | slash commands              |
+| <kbd>@</kbd>                                               | file picker                 |
+| <kbd>alt</kbd> <kbd>enter</kbd>                            | queue follow-up             |
+| <kbd>alt</kbd> <kbd>↑</kbd>                                | restore queued text         |
+| <kbd>j</kbd> / <kbd>k</kbd> or <kbd>↑</kbd> / <kbd>↓</kbd> | move or scroll focused pane |
+| <kbd>gg</kbd> / <kbd>G</kbd>                               | top / bottom                |
+
+## license
+
+mit