diff --git a/CLI.md b/CLI.md
index 2e5c8dfa..1f0b998b 100644
--- a/CLI.md
+++ b/CLI.md
@@ -826,6 +826,31 @@ Example (JSON):
 wl --json init
 ```
 
+### `piman` | `pi` [options]
+
+Launch the Pi-based TUI: browse and manage work items with agent chat and action palette. This is the agent-centric TUI that replaces the legacy Opencode-based interface. All worklog operations are performed via the `wl` CLI.
+
+Options:
+
+- `--in-progress` — Show only in-progress items.
+- `--all` — Include completed/deleted items in the list.
+- `--prefix <prefix>` — Override the default prefix.
+- `--headless` — Run in headless mode for CI scripting and automated tests.
+
+Example:
+
+```sh
+wl piman
+wl pi --in-progress
+```
+
+The Pi TUI can also be installed as a Pi package:
+
+```sh
+pi install ./packages/tui
+wl-piman
+```
+
 ### `status` [options]
 
 Show Worklog system and database status (counts, configuration values).
diff --git a/docs/tutorials/04-using-the-tui.md b/docs/tutorials/04-using-the-tui.md
index 51f6591f..1b14c141 100644
--- a/docs/tutorials/04-using-the-tui.md
+++ b/docs/tutorials/04-using-the-tui.md
@@ -183,4 +183,4 @@ Press `q`, `Esc`, or `Ctrl+C` to quit the TUI. All changes made during the sessi
 
 - [Planning and Tracking an Epic](05-planning-an-epic.md) -- organize complex features
 - [TUI Reference](../../TUI.md) -- complete TUI documentation
-- [OpenCode TUI Integration](../../docs/opencode-tui.md) -- detailed OpenCode docs
+- [Pi TUI Migration Guide](../../docs/opencode-to-pi-migration.md) -- migrating from OpenCode to Pi