nebula-ai 0.0.21 → 0.0.22-dev.20260601004945.fe57a77
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -15
- package/bin/nebula-ai.js +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -50,19 +50,20 @@ The TUI gives you a full dashboard with agents, channels, and settings — all n
|
|
|
50
50
|
|
|
51
51
|
### Navigation
|
|
52
52
|
|
|
53
|
-
- **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.
|
|
54
53
|
- **Tab / Shift+Tab** — cycle between Agents, Channels, and Settings sections on the home screen.
|
|
55
54
|
- **@ / #** — jump directly to the Agents or Channels section.
|
|
55
|
+
- **n** — create a new channel from the home screen. **d** — start a new DM with an agent.
|
|
56
56
|
- **Vim-style motion** — `j`/`k` up/down, `h`/`Esc` back, `l`/`Enter` open. Works everywhere lists are rendered.
|
|
57
57
|
- **Tab bar** — `h`/`l` switch between open tabs, `x` closes the current tab.
|
|
58
|
-
- **Status bar** — always-on mode badge (`NAV` / `INSERT` / `HITL`
|
|
59
|
-
- **q** from any navigation-mode screen exits cleanly.
|
|
58
|
+
- **Status bar** — always-on mode badge (`NAV` / `INSERT` / `HITL`), breadcrumb, contextual key hints, and a live connection indicator.
|
|
59
|
+
- **q** from any navigation-mode screen exits cleanly. Press **Ctrl+C** twice to quit from anywhere.
|
|
60
|
+
- **?** — open the full keyboard shortcut reference.
|
|
60
61
|
|
|
61
62
|
### Chat
|
|
62
63
|
|
|
63
64
|
- **Markdown rendering** — agent responses display bold, italic, inline code, headings, and clickable links.
|
|
64
65
|
- **Per-channel model selection** — press `m` in any DM or channel to open the model picker. Verified and experimental model lists are surfaced separately; a global default model can be set in Settings.
|
|
65
|
-
- **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. When the local device daemon is running, files are
|
|
66
|
+
- **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. When the local device daemon is running with computer control enabled, files are read directly from your host instead of being uploaded to the cloud.
|
|
66
67
|
- **Activity log** — tool calls and execution details are surfaced inline in chat, with `Enter` on a completed turn opening the full activity log.
|
|
67
68
|
- **Entity navigation** — press `Tab` on a selected message to cycle through referenced agents, triggers, files, and skills; `Enter` opens the detail view.
|
|
68
69
|
- **Message history** — press `↑` from an empty input (or `k` in navigation mode) to scroll back through previous turns.
|
|
@@ -87,28 +88,29 @@ npx nebula-ai user config set theme tokyo-night
|
|
|
87
88
|
|
|
88
89
|
### Settings
|
|
89
90
|
|
|
90
|
-
Reachable from the home screen
|
|
91
|
+
Reachable from the home screen's `Settings` row:
|
|
91
92
|
|
|
92
93
|
- **Profile & Account** — username, email, display name.
|
|
93
94
|
- **Default Model** — global LLM fallback for new chats.
|
|
94
95
|
- **Local Device** — daemon status, start/stop/restart controls, device ID.
|
|
95
|
-
- **
|
|
96
|
+
- **Folders** — add/remove host folders the daemon is allowed to read and write under.
|
|
96
97
|
- **Files** — browse and manage files stored on the platform.
|
|
97
98
|
- **Configuration** — theme, color, verbose, auto-focus, session restore, telemetry.
|
|
98
99
|
|
|
99
|
-
## Local device
|
|
100
|
+
## Local device
|
|
100
101
|
|
|
101
|
-
For long-running tasks, agents can execute code on your own machine
|
|
102
|
+
For long-running tasks, agents can execute code on your own machine directly — this is opt-in via the **computer control** prompt during onboarding (`exec_mode = host`). Skip the prompt or pick "No" and the daemon refuses every exec / file / service RPC with `exec_host_disabled` until you opt in from Settings.
|
|
102
103
|
|
|
103
104
|
```sh
|
|
104
105
|
npx nebula-ai install # install and start the background daemon
|
|
105
106
|
npx nebula-ai local-device status # check daemon state
|
|
106
107
|
npx nebula-ai local-device folders add ~/code/my-project
|
|
107
|
-
npx nebula-ai
|
|
108
|
+
npx nebula-ai local-device exec-mode set host # opt into computer control
|
|
109
|
+
npx nebula-ai local-device exec-mode set none # turn it off again
|
|
108
110
|
npx nebula-ai uninstall # remove the daemon (use --keep-data to keep config/logs)
|
|
109
111
|
```
|
|
110
112
|
|
|
111
|
-
The daemon is installed as a native OS service — **launchd** on macOS, **systemd --user** on Linux, **Task Scheduler** on Windows — and runs under your user account so there's no root prompt.
|
|
113
|
+
The daemon is installed as a native OS service — **launchd** on macOS, **systemd --user** on Linux, **Task Scheduler** on Windows — and runs under your user account so there's no root prompt. Commands run inside the folders you register; the daemon refuses any cwd outside that allowlist.
|
|
112
114
|
|
|
113
115
|
## CLI commands
|
|
114
116
|
|
|
@@ -123,10 +125,9 @@ The same surface is available from the command line:
|
|
|
123
125
|
- `user variables` — manage global or agent-scoped variables and secrets.
|
|
124
126
|
- `user billing` — check balance, view transaction history, and configure auto top-up.
|
|
125
127
|
- `user files` — upload, download, list, share, and manage files and folders.
|
|
126
|
-
- `user devices` — manage your cloud
|
|
127
|
-
- `local-device` — manage the on-host daemon (status, logs, start, stop, restart, folders add/remove).
|
|
128
|
+
- `user devices` — manage your cloud devices (info, start, stop, rename, visibility, file browse/search, and long-running services: create, start, stop, logs).
|
|
129
|
+
- `local-device` — manage the on-host daemon (status, logs, start, stop, restart, folders add/remove, exec-mode get/set).
|
|
128
130
|
- `install` / `uninstall` — set up or tear down the on-host daemon as a background service.
|
|
129
|
-
- `shell` — open an interactive shell inside the local sandbox VM (`--shell <path>` to pick a different binary).
|
|
130
131
|
- `status` — current CLI, auth, daemon, device, and folder state.
|
|
131
132
|
- `login` / `logout` — authenticate or clear stored credentials.
|
|
132
133
|
|
|
@@ -146,7 +147,7 @@ No events are sent when telemetry is disabled.
|
|
|
146
147
|
|
|
147
148
|
| Path / variable | Purpose |
|
|
148
149
|
|---|---|
|
|
149
|
-
| `~/.nebula/` | Stored auth session, CLI settings,
|
|
150
|
+
| `~/.nebula/` | Stored auth session, CLI settings, daemon logs. |
|
|
150
151
|
| `~/.cache/nebula-ai/` | Cached prebuilt binary (per-version, per-platform). |
|
|
151
152
|
| `NEBULA_HOME` | Override the `~/.nebula` home directory. |
|
|
152
153
|
| `NEBULA_AI_CACHE_DIR` | Override the binary cache location. |
|
|
@@ -162,5 +163,5 @@ No events are sent when telemetry is disabled.
|
|
|
162
163
|
This CLI is developed in the [`nebula-desktop`](https://github.com/agent-labs-dev/nebula-desktop) Bun-workspaces umbrella alongside the desktop app and shared packages. Contributor docs:
|
|
163
164
|
|
|
164
165
|
- [`AGENTS.md`](./AGENTS.md) — CLI-specific build, dev, and architecture conventions.
|
|
165
|
-
- [`docs/`](./docs/) — working notes (local-device backend contracts, RPC port mappings
|
|
166
|
+
- [`docs/`](./docs/) — working notes (local-device backend contracts, RPC port mappings).
|
|
166
167
|
- The [workspace README](../../README.md) and [root `AGENTS.md`](../../AGENTS.md) cover umbrella-level conventions (gates, releases, packages).
|
package/bin/nebula-ai.js
CHANGED
|
@@ -61,7 +61,7 @@ MCowBQYDK2VwAyEAyAvta5v665Vd82jfFmuCEw3WpneUQboj936gYHQE4/0=
|
|
|
61
61
|
// the channel-appropriate base URL (dev vs prod). The `__NEBULA_AI_…__`
|
|
62
62
|
// sentinel lets us keep the checked-in source runnable for local tests
|
|
63
63
|
// without pointing at any real host.
|
|
64
|
-
const STAMPED_DOWNLOAD_BASE_URL = "https://app-assets.nebula.
|
|
64
|
+
const STAMPED_DOWNLOAD_BASE_URL = "https://app-assets.nebula-dev.ai/cli/dev";
|
|
65
65
|
const DOWNLOAD_BASE_URL = process.env["NEBULA_AI_DOWNLOAD_BASE"] ?? STAMPED_DOWNLOAD_BASE_URL;
|
|
66
66
|
const SUPPORTED_PLATFORMS = new Set([
|
|
67
67
|
"darwin-arm64",
|
|
@@ -149,7 +149,7 @@ function getCacheDir(version) {
|
|
|
149
149
|
/**
|
|
150
150
|
* Remove cached binaries for versions other than the current one.
|
|
151
151
|
* Only touches directories whose names are `v<semver>` — leaves
|
|
152
|
-
* non-version entries (e.g. `
|
|
152
|
+
* non-version entries (e.g. `update-check.json`) untouched.
|
|
153
153
|
* Best-effort: individual removal failures are silently ignored so one
|
|
154
154
|
* stuck directory doesn't prevent the rest from being cleaned up.
|
|
155
155
|
*/
|