@aiiware/aii 0.28.17 → 0.28.19

package/README.md

@@ -87,6 +87,14 @@ aii
 
 You get a rich terminal UI with streaming responses, syntax highlighting, diff previews, and autocomplete for slash commands.
 
+### Resume a saved conversation
+
+```bash
+aii resume
+```
+
+Browse **All workspaces**, choose a folder, then choose a conversation to continue. Aii validates the saved session and switches into its folder; your parent shell stays in its launch folder. See [Saved Conversations](#saved-conversations) for keyboard controls, search and exact-ID commands.
+
 ### Continue in AiiCloud
 
 ```bash
@@ -101,12 +109,12 @@ The link appears in terminal history after the welcome banner, followed by `Type
 `--remote-control` controls browser access. `--inference server` uses your configured Aii Server, whether local or remote; `--inference cloud` uses AiiCloud inference. Signing in for remote control does not change your inference preference. Omit `--inference` to use your saved preference, or the original conversation's settings when resuming.
 
 ```bash
-aii sessions list
-aii sessions info <full-id>
 aii resume <full-id> --remote-control
 ```
 
-Run this from the original workspace on the original machine to restore its saved context and AiiCloud conversation. Resume requires an intact, safely stopped saved session; interrupted work with an uncertain outcome is not automatically replayed. `/remote off` disables remote control during a session; `/remote on` enables it again. Enabling control does not copy earlier private messages into AiiCloud. Cloud inference keeps its ordinary configured history independently of remote control.
+Run this exact-ID command from the saved workspace on the computer holding the session to restore its context and AiiCloud conversation. To browse saved workspaces and conversations, see [Saved Conversations](#saved-conversations).
+
+`/remote off` disables remote control during a session; `/remote on` enables it again. Enabling control does not copy earlier private messages into AiiCloud. Cloud inference keeps its ordinary configured history independently of remote control.
 
 Manage directories offered for new web conversations with `aii cloud workspace list`, `add <path>` or `remove <label|path>`, then restart the hosting Aii process to apply the change.
 
@@ -512,15 +520,35 @@ MCP servers connect in the background during session start. If a server drops, `
 
 ### Saved Conversations
 
-List conversations saved on this computer, including sessions controlled through AiiCloud. Listing works offline and shows full IDs, workspaces, inference backends, and recovery status without displaying prompts.
+Run `aii resume` from any folder to browse conversations saved on this computer, including sessions controlled through AiiCloud. The picker starts in **All** workspaces; **Current** limits it to the folder where you launched Aii. Type to search by first message, full session ID or workspace path.
+
+Choose a workspace, press **→** or **Enter** to open its Sessions pane, then use **↑/↓** and **Enter** to resume a conversation. The active pane has a highlighted selection, and the selected full workspace path and session ID appear below the lists. On narrow terminals, the panes stack vertically.
+
+| Key | Picker action |
+| --- | --- |
+| ↑ / ↓ | Move through folders or sessions in the active pane |
+| → or Enter in Workspaces | Open the selected workspace's sessions |
+| Enter in Sessions | Validate and resume the selected conversation |
+| ← in Sessions | Return to Workspaces |
+| Tab / Shift+Tab | Cycle focus through Workspaces, Sessions and Scope |
+| ← / → with Scope focused | Select All / Current, then return to Workspaces |
+| Esc | Return to Workspaces, or cancel from Workspaces |
+| Ctrl+C | Exit the picker |
+
+Selecting a session rechecks its saved state and folder before launch, then switches **only the Aii process** into the saved folder. Your parent shell stays in its launch folder. Running, unavailable or recovery-required sessions explain why they cannot resume. Resume requires an intact, safely stopped session; interrupted work with an uncertain outcome is not automatically replayed.
+
+For an exact session or a script, use the full ID. **Exact-ID commands still require you to run from the saved workspace.** The picker requires an interactive terminal; `aii sessions list` works offline and shows full IDs, workspaces, inference backends and recovery status without displaying prompts.
 
 ```bash
+aii resume                         # Browse workspaces, then conversations (terminal only)
 aii sessions list                  # Browse saved conversations on this computer
 aii sessions info <full-id>        # Check status and resume instructions
 aii resume <full-id>               # Run from the saved workspace
 aii resume <full-id> --remote-control  # Enable control from AiiCloud
 ```
 
+After a saved interactive session ends cleanly with `/exit` or Ctrl+D, the summary's **Resume** section includes the full resume command and picker label. Commands too long for the frame remain complete below it. Ctrl+C leaves plain resume guidance. If the latest save is unconfirmed or needs recovery, the guidance points to session details instead.
+
 Inside a conversation, `/sessions` and `/sessions info <full-id>` show the same saved catalog. An open session must finish or close before another process can resume it. Hosted conversations continue in AiiCloud with their computer connected; unresolved execution requires recovery before resuming.
 
 For conversations managed by the separate Aii Server Session API, use `aii sessions server list` or `aii sessions server resume <id>`. These commands use your configured Aii Server regardless of your inference preference.
@@ -607,6 +635,7 @@ See the [Privacy Policy](https://aiiware.com/privacy#cli-usage-analytics) for ex
 | `aii run git commit [-y]` | AI-powered git commit |
 | `aii loop [query] [--flags]` | Autonomous agent loop |
 | `aii --remote-control` | Enable AiiCloud continuation and new web conversations |
+| `aii resume` | Browse All/Current workspaces and resume in the selected session's folder |
 | `aii resume <session-id>` | Restore an exact saved conversation in its original workspace |
 | `aii cloud <action>` | AiiCloud sign-in, status and workspace management |
 | `aii config <action>` | Configuration management |