Stay on your problem. Let independent work run in parallel.
+
- Stay on your problem. Let independent work run in parallel.
- OpenPI adds a local Web workbench, isolated-context subagents, and Workflows to Pi.
- It keeps your models, tools, and Skills — everyday coding stays light, advanced capabilities unfold when needed.
+ OpenPI adds isolated subagents, replay-safe Workflows and a local Web workbench to Pi —
+ inside Pi's own sessions, providers, tools, Skills and Trust. Everyday coding stays light; power unfolds when you ask for it.
@@ -31,17 +36,13 @@ pi install npm:@tt-a1i/openpi
OpenPI is an independent community project, unaffiliated with Physical Intelligence's openpi robotics project and with the Pi team.
----
-
-## What OpenPI is
+
-Pi is deliberately small: an agent loop, tools, sessions, and an extension API. OpenPI is a capability layer that stays inside Pi's lifecycle, sessions, providers, and trust boundaries — not a second agent operating system.
-
-- **Local Web workbench** — manage workspaces and sessions in the browser, and inspect saved prompts, tool arguments, and results. Independent of terminal sessions.
-- **Subagents** — delegate self-contained work to in-process Pi sessions with isolated context; results are delivered automatically.
-- **Workflows** — multi-phase, multi-agent orchestration with structured results, safe replay, and auditable artifacts.
-- **Terminal experience** — a status footer, compact tool results, Plan mode, and session-scoped helpers.
-- **Pi-native** — your provider, models, tools, Skills, sessions, and Trust stay in charge; OpenPI only adds capabilities at Pi's extension seams.
+
+
+
+ Real OpenPI Web workbench and real tool calls against a small demo repository. Model replies come from a scripted local provider so the recording is reproducible.
+
## Quick start
@@ -49,12 +50,7 @@ Pi is deliberately small: an agent loop, tools, sessions, and an extension API.
pi install npm:@tt-a1i/openpi
```
-Restart Pi, or run `/reload` in the current session. Then describe real work:
-
-```text
-Start the dev server in the background with `nohup npm run dev &`, then keep
-editing the page; check on it with ordinary process commands when needed.
-```
+Restart Pi, or run `/reload` in the current session. Then describe real work — the model decides how to split it:
```text
Spawn subagents to check the login flow and its tests in parallel, each with
@@ -66,15 +62,109 @@ Use a workflow to review these modules: collect issues in parallel, verify the
findings, then synthesize what to fix first.
```
-The model decides how to split the work; OpenPI provides execution, status, results, and stop controls. Only genuinely independent tasks benefit from parallelism — the gain depends on the task, model, and configuration.
+```text
+Start the dev server in the background with `nohup npm run dev &`, then keep
+editing the page; check on it with ordinary process commands when needed.
+```
-Prefer a browser? Type `/web` in Pi, open the local address printed in the terminal, pick a model and workspace, and start chatting. Web sessions are independent and never take over a terminal conversation. See [Web workbench](#web-workbench).
+Prefer a browser? Type `/web` in Pi and open the local address printed in the terminal. Web sessions are independent and never take over a terminal conversation. Configure OpenPI itself in plain language with `/openpi-setup`.
+
+OpenPI provides execution, status, results and stop controls. Only genuinely independent tasks benefit from parallelism — the gain depends on the task, model and configuration.
+
+## Why OpenPI
+
+Pi is deliberately small: an agent loop, tools, sessions and an extension API. OpenPI is a capability layer that stays inside Pi's lifecycle, sessions, providers and trust boundaries — not a second agent operating system.
+
+
+
+
+
Isolated subagents
+ Delegate self-contained work to in-process Pi sessions with their own context. They run concurrently and report back automatically — optionally in their own Git worktree.
+
+
+
Replay-safe workflows
+ Script multi-phase, multi-agent runs with phase, agent, parallel and pipeline. Structured results, a journal, safe replay and auditable artifacts.
+
+
+
Local Web workbench
+ Workspaces, sessions, changes, files and a trajectory inspector for every model and tool call — in a browser, authenticated, on your machine.
+
+
+
+
+
Plan mode & human input
+ /plan researches read-only, then turns an explicit Plan Ready into implementation. ask_user and human_handoff collect decisions only you can make.
+
+
+
Semantic navigation
+ A bundled Skill asks an existing local language server for definitions, references and diagnostics — on demand, never started on launch.
+
+
+
Pi-native and quiet
+ Your provider, models, tools, Skills and Trust stay in charge. A fixed resident tool set, no theme or model changes on install, no extra model calls by default.
+
+
+
+
+### New in v1.2.0
+
+- **Semantic navigation Skill** for definitions, references and single-file diagnostics through a local language server. ([#916](https://github.com/openpi-dev/openpi/pull/916))
+- **Context composition** in the Web usage popover: system text, tool declarations and conversation of the latest call. ([#914](https://github.com/openpi-dev/openpi/pull/914))
+- **Trajectory overview** with context/model/tool tracks, search and a per-call inspector, plus a refreshed workbench, themes and model picker. ([#868](https://github.com/openpi-dev/openpi/pull/868), [#894](https://github.com/openpi-dev/openpi/pull/894), [#904](https://github.com/openpi-dev/openpi/pull/904), [#865](https://github.com/openpi-dev/openpi/pull/865))
+- **Quoted review and plan snippets keep their source** (repository, comparison, revision or session). ([#915](https://github.com/openpi-dev/openpi/pull/915))
+- **↑/↓ prompt history** in the Web composer, and **custom thinking levels** for custom models. ([#912](https://github.com/openpi-dev/openpi/pull/912), [#864](https://github.com/openpi-dev/openpi/pull/864))
+- CI now covers the **minimum and latest supported Pi hosts**. ([#719](https://github.com/openpi-dev/openpi/pull/719)) — [Full release notes](https://github.com/openpi-dev/openpi/releases/tag/v1.2.0)
+
+## See it work
-Configure OpenPI's own preferences through natural language:
+
+
+
+
+
+
+
+ Delegate, keep working, inspect. The parent stays free while two isolated subagents audit code; open any child's transcript read-only.
+
-```text
-/openpi-setup
-```
+
+
+
+
+
+
+
+
+
Review every change Working-tree diffs beside the turn that made them.
+
+
+
+
+
+
+
+
Trace every call Context, model and tool tracks with a per-call inspector.
+
+
+
+
+
+
+
+
Know your context What the latest call actually sent, and session totals.
+
+
+
+
+## How it fits together
+
+
+
+
+
+
+
+
## Light by default
@@ -227,6 +317,9 @@ Safety here is a runtime constraint, not a prompt.
### Defaults
+
+All defaults — every setting starts here; staying at defaults creates no file.
+
| Setting | Default |
| --- | --- |
| Code Mode (`code_mode_enabled`) | Off; opt in via `/openpi-setup` |
@@ -254,6 +347,8 @@ Safety here is a runtime constraint, not a prompt.
| Post-edit command | Off; a single command of at most 500 characters |
| Built-in role models | All inherit the parent model |
+
+
Settings → General saves the follow-up default in `ui.webFollowUpBehavior`. The composer override and Command/Ctrl+Enter change only one message. After the active turn ends, the next explicit submit starts a normal turn; the draft is never sent automatically. `/openpi-setup` edits the same preference.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index e9dc221ec..cf0a1b1a5 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,11 +1,18 @@
+
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+