nebula-ai 0.0.12 → 0.0.13

package/README.md

@@ -20,38 +20,64 @@ npx nebula-ai chat "summarize the open issues in repo X"
 
 **Supported platforms:** macOS (arm64, x64), Linux (x64, arm64), Windows (x64).
 
-## What you can do
+## Interactive TUI
 
-The interactive TUI gives you a dashboard of your agents and channels, a streaming chat view with live tool-execution indicators, an activity log, drill-down details for agents/skills/triggers/files, and a settings area for billing, devices, and folder mounts.
+The TUI gives you a full dashboard with agents, channels, and settings — all navigable from the keyboard.
 
-The same surface is available from the command line, grouped under:
+### Navigation
+
+- **Ctrl+K command palette** — jump to any agent, channel, or settings page instantly. Start typing to filter, or create channels and send messages directly from the palette.
+- **Tab / Shift+Tab** — cycle between Agents, Channels, and Settings sections on the home screen.
+- **@ / #** — jump directly to the Agents or Channels section.
+
+### Chat
+
+- **Markdown rendering** — agent responses display bold, italic, inline code, headings, and clickable links.
+- **Per-channel model selection** — press `m` in any DM or channel to switch the AI model for that conversation. A global default model can be set in Settings.
+- **File attachments** — drag and drop files from your file manager into the chat input. Files appear as chips above the message area and are sent with your next message.
+- **Activity log** — tool calls and execution details are surfaced inline in chat, with a keystroke to open the full activity log for a completed turn.
+- **Interactive prompts** — when an agent asks a multi-choice question, it renders as a widget with option descriptions, number-key shortcuts (1–9), and an "Other" free-text fallback.
+- **Auto-focus input** — configurable in Settings. When disabled, chats open in navigation mode; press `i` to start typing.
+
+### Workspace & session
+
+- **Multi-tab workspace** — tabs dynamically resize to your terminal width and scroll horizontally when they overflow.
+- **Instant tab switching** — previously visited screens load from cache while fresh data is fetched in the background (stale-while-revalidate).
+- **Session restore** — enable in Settings to automatically reopen your tabs and navigation state when you restart the CLI.
+
+## CLI commands
+
+The same surface is available from the command line:
 
 - `chat` — send a message to an agent (`-a/--agent`, `-c/--channel`, `--no-stream`).
-- `channels` — list, create, get, delete, archive, share, and inspect conversation threads.
-- `agents` — list, create, update, enable/disable, view logs, manage triggers, and attach/detach skills.
-- `user` — profile, billing, devices, files, and global or agent-scoped variables (including secrets).
-- `status` — current CLI, daemon, and device state.
+- `channels` — list, create, get, delete, archive, unarchive, share, update, and view messages in conversation threads.
+- `agents` — list, create, update, delete, enable/disable, view logs/errors, manage triggers, and attach/detach skills.
+- `user` — profile, billing, files, variables (including secrets), and local config.
+  - `user config` — list, get, set, and reset configuration values; list available AI models.
+  - `user variables` — manage global or agent-scoped variables and secrets.
+  - `user billing` — check balance, view transaction history, and configure auto top-up.
+  - `user files` — upload, download, list, share, and manage files and folders.
+- `status` — current CLI and device state.
+- `login` / `logout` — authenticate or clear stored credentials.
 
 Every command supports `--json` for machine-readable output, `-v/--verbose` for extra detail, and `--no-color` to disable ANSI styling.
 
-## Local device sandbox
+## Privacy and telemetry
 
-`nebula-ai` can run a background daemon on your machine that exposes a sandboxed VM agents can execute code in, with explicit folder mounts for the directories you want them to touch.
+The CLI collects anonymized usage analytics (via PostHog) to help improve the product. You can opt out at any time:
 
-```sh
-npx nebula-ai install                              # set up the daemon as a background service
-npx nebula-ai local-device folders add ~/code/my-project
-npx nebula-ai shell                                # open an interactive bash shell inside the sandbox
-npx nebula-ai uninstall                            # remove the daemon
-```
+- Toggle telemetry off in the TUI under **Settings > Configuration**
+- From the CLI: `npx nebula-ai user config set telemetry false`
+- Or set `DO_NOT_TRACK=1` (or `NEBULA_DO_NOT_TRACK=1`) in your environment
 
-The installer registers your machine as a device, pulls the sandbox image, and creates a launchd (macOS), systemd (Linux), or scheduled-task (Windows) entry.
+No events are sent when telemetry is disabled.
 
 ## Configuration
 
 | Path / variable | Purpose |
 |---|---|
-| `~/.config/nebula-cli/` | Stored auth session, sandbox config, and daemon logs. |
+| `~/.config/nebula-cli/` | Stored auth session and CLI settings. |
 | `~/.cache/nebula-ai/` | Cached prebuilt binary. |
 | `NEBULA_AI_CACHE_DIR` | Override the binary cache location. |
 | `NEBULA_AI_DOWNLOAD_BASE` | Use an alternate mirror for the prebuilt binary download (useful behind restrictive firewalls). |
+| `DO_NOT_TRACK` / `NEBULA_DO_NOT_TRACK` | Set to `1` to disable product telemetry. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nebula-ai",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "CLI/TUI for the nebula.gg AI task orchestration platform",
   "type": "module",
   "bin": {