@firstpick/pi-package-webui 0.3.1 → 0.3.3

package/README.md

@@ -82,7 +82,7 @@ Use the CLI when you want to start the Web UI without first opening terminal Pi:
 
 ```bash
 npm install -g @firstpick/pi-package-webui
-pi-webui --cwd ~/src/my-project
+pi-webui
 ```
 
 ```text
@@ -92,7 +92,7 @@ pi-webui [options] [-- <pi args...>]
 ```text
   --host <host>       HTTP bind host (default: 127.0.0.1)
   --port <port>       HTTP port (default: 31415)
-  --cwd <path>        Default working directory for Pi tabs (default: current dir)
+  --cwd <path>        Start the first Pi terminal in this working directory
   --pi <command>      Pi executable to spawn (default: bundled dependency, then "pi")
   --no-session        Start Pi RPC with --no-session
   --name <name>       Initial Web UI tab name
@@ -100,9 +100,12 @@ pi-webui [options] [-- <pi args...>]
   -v, --version       Print version
 ```
 
+If `--cwd` is omitted, the server starts first and the browser asks for the first terminal CWD.
+
 Examples:
 
 ```bash
+pi-webui
 pi-webui --cwd ~/src/my-project
 pi-webui --port 3000 -- --model anthropic/claude-sonnet-4-5:high
 PI_WEBUI_PI_BIN=/path/to/pi pi-webui --no-session
@@ -116,6 +119,7 @@ Environment variables:
 
 ## Main features
 
+- Pathless `pi-webui` startup: the server opens first, then the browser prompts for the first terminal CWD.
 - Multi-tab Pi sessions with isolated processes, working directories, prompt drafts, and activity state.
 - Automatic tab naming from the first prompt, with `--name <name>` still available for an explicit initial tab name.
 - Streaming chat transcript with Markdown, thinking output, tool/bash cards, queue and compaction events, and abort controls.
@@ -124,6 +128,7 @@ Environment variables:
 - Model, thinking, session, workspace, theme, optional-feature, Codex usage, network, event, and notification controls in the side panel.
 - Side-panel theme picker backed by optional `@firstpick/pi-themes-bundle` themes when loaded.
 - Per-tab cwd changes, a clickable footer cwd picker, saved path fast picks, server-persisted fast picks, and restart-safe restoration of open tabs.
+- Detected app runner dropdown for the active tab cwd, including Cargo, Bun, npm/npx/pnpm, Python/uv, Go/Golang, Zig, C/C++, Docker Compose, root/dev/scripts shell scripts, and other common project runners with live output pinned at the top of the terminal. Projects can add browseable custom runners in `.pi-webui-runners.json` with a command (default `./`) plus a relative path to the file to run.
 - Browser support for Pi extension UI prompts, widgets, status updates, browser notifications when a tab needs an extension UI response and an optional side-panel toggle for agent-done notifications.
 - Feedback reactions (`👍`, `👎`, `?`) on final assistant output plus tool/bash action cards, which can ask Pi to create or update a LEARNING.
 - Mobile-friendly layout and PWA install support where the browser allows it.
@@ -168,7 +173,11 @@ The Git workflow button runs local git commands in the active Pi working directo
 4. Commit with the selected message
 5. Run `git push`
 
-This requires `/git-staged-msg` from `@firstpick/pi-prompts-git-pr`. Review the generated commit message before committing or pushing.
+After the message is generated, **Create PR** asks Pi to generate `dev/COMMIT/staged-branch-name.txt`, lets you confirm or edit the `type/feature-name` branch, then switches with `git switch -c` before committing. In PR mode, choose **Commit short** or **Commit long**, then **Push and Create PR** pushes the branch, sends `/pr`, shows the generated `dev/PR/<branch>.md` description for editing/confirmation, and creates the pull request with `gh pr create`. Use **Manual branch** to skip agent branch-name generation and type the branch directly.
+
+Use the workflow process buttons to jump directly to **Stage**, **Message**, **Commit**, or **Push** when earlier work was already completed manually. Selecting **Commit** loads the current generated files from `dev/COMMIT/` before enabling the commit choices. A yellow dot means that process was selected or is available but its action has not completed in this workflow; green means the process action completed.
+
+This requires `/git-staged-msg` and `/pr` from `@firstpick/pi-prompts-git-pr`; branch-name generation uses `/git-branch-name` when available and otherwise sends an equivalent inline prompt. Creating the PR also requires an authenticated GitHub CLI (`gh`). Review the generated commit message, branch name, and PR description before committing, pushing, or creating a PR.
 
 ## Mobile and PWA notes