skydive-cli 0.2.0 → 0.3.0-beta.764

package/CHANGELOG.md

@@ -5,6 +5,48 @@ All notable changes to the Skydive CLI are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.3.0] - 2026-08-04
+
+### Added
+
+**Chat TUI**
+
+- `/fork` slash command to fork a conversation at any point and continue in a new thread.
+- `/conversation` switches threads from inside a live session.
+- `/compact` triggers manual conversation compaction.
+- `/portal` and `/copy` slash commands.
+- Archive the current conversation from the chat TUI.
+- `--new` flag on `skydive chat` to start a fresh conversation.
+- Debounced server-side conversation search in the picker, with title matches ranked first.
+- File review pane orientation toggle, and review comments in the file pane.
+- Pinned plan card controls and a jump-to-latest hint.
+- Terminal title (OSC) follows the live conversation title on every screen; inside cmux the workspace is renamed too, and linked PRs are pushed to the cmux sidebar.
+- Every participating agent shows in the conversation list; connect cards each have their own identity, and ctrl+r asks which connect card to act on.
+- Colored Skydive splash art in `skydive --help` and the TUI pickers.
+- New-agent name prefilled from the server's suggestion.
+
+**CLI & platform**
+
+- `skydive update` self-updater, with an update notice when a new version is available.
+- Shell completions for bash, zsh, and fish via `completion install`.
+- Portal daemon: one connection per host with per-conversation working directories.
+- Agent-led coding-agent import (`skydive import`).
+- Per-workspace scoping on the REST client, and cross-org `--agent <uuid>` auto-switches workspace.
+- `skydive-beta` wrapper for the canary channel.
+
+### Fixed
+
+- `skydive update` no longer claims an update is available on every npm install.
+- Chat memory is bounded (payload clamps + windowed rows) with a memory watchdog and OOM diagnostic report; transcript rows are memoized so streaming stops re-rendering the whole chat.
+- Chat-send failures map to real error messages.
+- Notification and sidebar previews use the last text block of the reply and strip inline markdown.
+- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.
+- Sending to non-web channel conversations is blocked in the TUI.
+- GitHub bot connect opens on the web front door, not api.skydive.com.
+- TUI activity counter times from the run, not the screen.
+
 ## [0.2.0] - 2026-07-29
 
 ### Added

package/README.md

@@ -6,6 +6,53 @@ The Skydive CLI — manage agents and chat with them from the terminal.
 npx skydive-cli --help
 ```
 
+## Installing
+
+Two ways to install, depending on whether you have a Node toolchain:
+
+**npm (needs Node ≥ 20):**
+
+```sh
+npm install -g skydive-cli   # then: skydive --help
+# or run without installing:
+npx skydive-cli --help
+```
+
+**Standalone binary (no Node required):**
+
+```sh
+curl -fsSL https://skydive.com/api/v1/cli/install.sh | sh
+```
+
+Installs a self-contained `skydive` to `~/.local/bin`. The installer detects
+your OS/arch, downloads the matching binary from the release CDN, verifies its
+sha256, and installs it. Options via env vars: `SKYDIVE_CHANNEL=canary` for the
+canary line, `SKYDIVE_VERSION=X.Y.Z` to pin a version, `SKYDIVE_INSTALL_DIR` to
+choose the directory.
+
+## Updating
+
+```sh
+skydive update            # update to the latest release
+skydive update --check    # just report whether an update is available
+```
+
+A **binary** install self-updates in place (download → verify sha256 → atomic
+replace). An **npm/yarn/pnpm/bun** install is owned by your package manager, so
+`skydive update` offers to run the right upgrade command for it and relaunches
+the CLI on the new version.
+
+The CLI also checks for updates in the background (at most once a day, never
+blocking a command) and prints a one-line notice when a newer version exists.
+Control this in `config.json` or via env vars:
+
+- `autoupdate`: `"patch"` (default — silently self-apply a stable **patch**
+  release of a binary install; notify for minor/major, canary, and
+  package-manager installs), `"notify"` (only ever print the notice), or
+  `false` (no auto-update and no notice). Env override: `SKYDIVE_AUTOUPDATE`.
+- `updateCheck: false` (or `SKYDIVE_NO_UPDATE_CHECK` / `NO_UPDATE_NOTIFIER`)
+  turns the background check off entirely.
+
 ## Authentication
 
 Sign in once via the browser — the same shape as `doppler login`: the CLI
@@ -84,10 +131,45 @@ skydive portal open             # open the portal to this machine, headless
 skydive portal grant --agent <id|name>
 skydive portal revoke --agent <id|name>
 skydive portal status
+
+skydive completion install      # set up TAB completion for your shell
 ```
 
 Global flags: `--json`, `--quiet`, `--api-url <url>`.
 
+## Shell completions
+
+bash, zsh, and fish. One command sets them up for the shell you're in:
+
+```sh
+skydive completion install
+```
+
+It writes to `~/.bashrc` (or `~/.bash_profile` on macOS), `~/.zshrc`, or
+`~/.config/fish/completions/skydive.fish`, respecting `ZDOTDIR` and
+`XDG_CONFIG_HOME`, and picking whichever bash startup file you already have.
+Open a new shell to pick them up. Re-running it — after an upgrade, say —
+refreshes the block it wrote instead of appending a second copy, and leaves
+the rest of the file alone. Pass a shell explicitly to set up one you're not
+currently in: `skydive completion install fish`.
+
+To see the script instead of installing it, or to source it from somewhere of
+your own choosing:
+
+```sh
+skydive completion zsh            # print it
+eval "$(skydive completion bash)" # this shell only
+```
+
+The script doesn't contain the command list — it asks the CLI for candidates
+on each TAB, so completions never drift from the installed version. That
+covers commands, subcommands, flags, and the values of flags with a fixed set
+(`skydive agents list --scope <TAB>` → `mine org`). One TAB costs one short
+CLI invocation (~150 ms).
+
+zsh and fish show each command's description alongside it; bash lists names
+only.
+
 ## `skydive import`
 
 Migrating from Claude Code, Cursor, or OpenCode? `skydive import` opens a
@@ -176,6 +258,13 @@ internal API. On launch it walks you through:
    formatting, collapsed reasoning, and rich rendering of tool calls
    (`bash`, `edit`/`write` diffs, `read`, `grep`/`glob`).
 
+You can change conversation without leaving chat. `/conversation` (aliases
+`/conversations`, `/conv`) reopens the conversation list, and
+`/conversation <id>` — an id, its `/c/<id>` link, or a pasted
+`skydive chat --resume <id>` line — jumps straight into that thread, including
+one belonging to a **different** agent. Either way the run you leave behind
+keeps going server-side; reopening it reattaches to the stream.
+
 Runs under **Node** like every other command. The TUI renders through
 OpenTUI, whose native core needs the [Bun](https://bun.sh) runtime, so the
 first `chat` run downloads a private, pinned Bun and re-execs under it
@@ -237,28 +326,31 @@ management API used by `agents`/`keys`.
 
 ### Keybindings
 
-| Context             | Key           | Action                                |
-| ------------------- | ------------- | ------------------------------------- |
-| Pickers             | _type_        | filter the list                       |
-| Pickers             | `↑` / `↓`     | move selection                        |
-| Pickers             | `↵`           | open / select                         |
-| Pickers             | `esc`         | back                                  |
-| Agent picker        | `ctrl+n`      | create an agent                       |
-| Agent picker        | `ctrl+w`      | switch workspace                      |
-| Agent picker        | `tab`         | toggle mine / whole-org agents        |
-| Conversation picker | `ctrl+d`      | delete the highlighted conversation   |
-| Chat                | `↵`           | send (or queue, while streaming)      |
-| Chat                | `pgup`/`pgdn` | scroll the transcript                 |
-| Chat                | `ctrl+c`      | cancel the active run; again to quit  |
-| Chat                | `esc`         | back to the conversation picker       |
-| Chat                | `ctrl+p`      | switch model                          |
-| Chat                | `ctrl+o`      | switch theme                          |
-| Chat                | `ctrl+t`      | grant / revoke local machine access   |
-| Chat                | `ctrl+l`      | open this conversation in the browser |
-| Chat                | `ctrl+r`      | run the newest pending connect card   |
-| Chat                | `ctrl+v`      | paste an image from the clipboard     |
-| Chat                | `ctrl+x`      | drop the most recently staged image   |
-| Chat                | `?`           | show the keybinding reference         |
+| Context             | Key           | Action                                     |
+| ------------------- | ------------- | ------------------------------------------ |
+| Pickers             | _type_        | filter the list                            |
+| Pickers             | `↑` / `↓`     | move selection                             |
+| Pickers             | `↵`           | open / select                              |
+| Pickers             | `esc`         | back                                       |
+| Agent picker        | `ctrl+n`      | create an agent                            |
+| Agent picker        | `ctrl+w`      | switch workspace                           |
+| Agent picker        | `tab`         | toggle mine / whole-org agents             |
+| Conversation picker | `ctrl+a`      | archive / restore it for you only          |
+| Conversation picker | `ctrl+d`      | delete the highlighted conversation        |
+| Conversation picker | `shift+tab`   | show / hide the ones you archived          |
+| Chat                | `↵`           | send (or queue, while streaming)           |
+| Chat                | `pgup`/`pgdn` | scroll the transcript                      |
+| Chat                | `ctrl+c`      | cancel the active run; again to quit       |
+| Chat                | `esc`         | back to the conversation picker            |
+| Chat                | `ctrl+a`      | archive this conversation (empty composer) |
+| Chat                | `ctrl+p`      | switch model                               |
+| Chat                | `ctrl+o`      | switch theme                               |
+| Chat                | `ctrl+t`      | grant / revoke local machine access        |
+| Chat                | `ctrl+l`      | open this conversation in the browser      |
+| Chat                | `ctrl+r`      | run the newest pending connect card        |
+| Chat                | `ctrl+v`      | paste an image from the clipboard          |
+| Chat                | `ctrl+x`      | drop the most recently staged image        |
+| Chat                | `?`           | show the keybinding reference              |
 
 Messages typed while a response is streaming are **queued** and sent in
 order as each run finishes; `ctrl+c` cancels the current run and clears the