@agent-nexus/cli 0.1.8 → 0.1.11
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 +35 -31
- package/dist/index.js +2837 -160
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -180,14 +180,14 @@ nexus auth status
|
|
|
180
180
|
|
|
181
181
|
When determining which profile to use, the CLI checks (first match wins):
|
|
182
182
|
|
|
183
|
-
| Priority | Source
|
|
184
|
-
|
|
185
|
-
| 1
|
|
186
|
-
| 2
|
|
187
|
-
| 3
|
|
188
|
-
| 4
|
|
189
|
-
| 5
|
|
190
|
-
| 6
|
|
183
|
+
| Priority | Source | Example |
|
|
184
|
+
| -------- | --------------------------------------- | ------------------------------------------ |
|
|
185
|
+
| 1 | `--api-key` flag or `NEXUS_API_KEY` env | Bypasses profiles entirely |
|
|
186
|
+
| 2 | `--profile` flag | `nexus agent list --profile work` |
|
|
187
|
+
| 3 | `NEXUS_PROFILE` env var | `export NEXUS_PROFILE=work` |
|
|
188
|
+
| 4 | `.nexusrc` file | Walks up directory tree to find `.nexusrc` |
|
|
189
|
+
| 5 | Active profile | Set by `nexus auth switch` |
|
|
190
|
+
| 6 | `"default"` profile | Fallback |
|
|
191
191
|
|
|
192
192
|
#### Remove profiles
|
|
193
193
|
|
|
@@ -257,13 +257,13 @@ These flags are available on every command:
|
|
|
257
257
|
|
|
258
258
|
| Flag | Description |
|
|
259
259
|
| ------------------ | ------------------------------------------------- |
|
|
260
|
-
| `--json`
|
|
261
|
-
| `--api-key <key>`
|
|
262
|
-
| `--base-url <url>`
|
|
263
|
-
| `--profile <name>`
|
|
264
|
-
| `--no-auto-update`
|
|
265
|
-
| `-v, --version`
|
|
266
|
-
| `--help`
|
|
260
|
+
| `--json` | Output results as JSON (for scripting and piping) |
|
|
261
|
+
| `--api-key <key>` | Override the API key for this invocation |
|
|
262
|
+
| `--base-url <url>` | Override the API base URL |
|
|
263
|
+
| `--profile <name>` | Use a specific named profile |
|
|
264
|
+
| `--no-auto-update` | Disable automatic CLI updates for this invocation |
|
|
265
|
+
| `-v, --version` | Print the CLI version and exit |
|
|
266
|
+
| `--help` | Show help for any command or subcommand |
|
|
267
267
|
|
|
268
268
|
### Environment Variables
|
|
269
269
|
|
|
@@ -412,14 +412,14 @@ All commands follow the pattern: `nexus <group> <action> [arguments] [options]`
|
|
|
412
412
|
|
|
413
413
|
### Core Platform
|
|
414
414
|
|
|
415
|
-
| Command | Subcommands
|
|
416
|
-
| ---------------------------------------------------------- |
|
|
415
|
+
| Command | Subcommands | Description |
|
|
416
|
+
| ---------------------------------------------------------- | ---------------------------------------------------------------- | ------------------------- |
|
|
417
417
|
| [`auth`](docs/command-reference.md#nexus-auth) | `login` `logout` `switch` `list` `pin` `unpin` `status` `whoami` | Authentication |
|
|
418
|
-
| [`agent`](docs/command-reference.md#nexus-agent) | `list` `get` `create` `update` `delete` `duplicate`
|
|
419
|
-
| [`agent-tool`](docs/command-reference.md#nexus-agent-tool) | `list` `get` `create` `update` `delete`
|
|
420
|
-
| [`version`](docs/command-reference.md#nexus-version) | `list` `get` `create` `update` `delete` `restore` `publish`
|
|
421
|
-
| [`folder`](docs/command-reference.md#nexus-folder) | `list` `create` `update` `delete` `assign`
|
|
422
|
-
| [`model`](docs/command-reference.md#nexus-model) | `list`
|
|
418
|
+
| [`agent`](docs/command-reference.md#nexus-agent) | `list` `get` `create` `update` `delete` `duplicate` | AI agent management |
|
|
419
|
+
| [`agent-tool`](docs/command-reference.md#nexus-agent-tool) | `list` `get` `create` `update` `delete` | Agent tool configurations |
|
|
420
|
+
| [`version`](docs/command-reference.md#nexus-version) | `list` `get` `create` `update` `delete` `restore` `publish` | Prompt version management |
|
|
421
|
+
| [`folder`](docs/command-reference.md#nexus-folder) | `list` `create` `update` `delete` `assign` | Agent folder organization |
|
|
422
|
+
| [`model`](docs/command-reference.md#nexus-model) | `list` | Available AI models |
|
|
423
423
|
|
|
424
424
|
### Workflows & Execution
|
|
425
425
|
|
|
@@ -470,15 +470,16 @@ All commands follow the pattern: `nexus <group> <action> [arguments] [options]`
|
|
|
470
470
|
| [`eval`](docs/command-reference.md#nexus-eval) | (subgroups: `session`, `dataset`, `execute`, `judge`, `results`, `formats`, `judges`) | AI task evaluation |
|
|
471
471
|
| [`ticket`](docs/command-reference.md#nexus-ticket) | `list` `get` `create` `update` `comment` `comments` | Bug and feature tracking |
|
|
472
472
|
| [`phone-number`](docs/command-reference.md#nexus-phone-number) | `search` `buy` `list` `get` `release` | Phone number management |
|
|
473
|
+
| [`channel`](docs/command-reference.md#nexus-channel) | `setup` `connection list\|create` `whatsapp-sender list\|create\|get` | Channel setup orchestrator |
|
|
473
474
|
| [`prompt-assistant`](docs/command-reference.md#nexus-prompt-assistant) | `chat` `get-thread` `delete-thread` | AI-assisted prompt writing |
|
|
474
475
|
|
|
475
476
|
### Utility
|
|
476
477
|
|
|
477
|
-
| Command | Subcommands
|
|
478
|
-
| ---------------------------------------------------- |
|
|
479
|
-
| [`api`](docs/command-reference.md#nexus-api) | (passthrough)
|
|
478
|
+
| Command | Subcommands | Description |
|
|
479
|
+
| ---------------------------------------------------- | --------------- | ------------------------------ |
|
|
480
|
+
| [`api`](docs/command-reference.md#nexus-api) | (passthrough) | Call any API endpoint directly |
|
|
480
481
|
| [`docs`](docs/command-reference.md#nexus-docs) | (topic browser) | View built-in documentation |
|
|
481
|
-
| [`upgrade`](docs/command-reference.md#nexus-upgrade) | (self-update)
|
|
482
|
+
| [`upgrade`](docs/command-reference.md#nexus-upgrade) | (self-update) | Upgrade the CLI to latest |
|
|
482
483
|
|
|
483
484
|
> **Full reference:** See [docs/command-reference.md](docs/command-reference.md) for complete documentation of every command, option, and example.
|
|
484
485
|
|
|
@@ -600,6 +601,9 @@ Every CLI command maps to an SDK method. Use the SDK (`@agent-nexus/sdk`) when b
|
|
|
600
601
|
| `nexus model list` | `client.models.list()` |
|
|
601
602
|
| `nexus ticket create --title X ...` | `client.tickets.create({ title: "X", ... })` |
|
|
602
603
|
| `nexus phone-number list` | `client.phoneNumbers.list()` |
|
|
604
|
+
| `nexus channel setup --type WHATSAPP` | `client.channels.getSetupStatus("WHATSAPP")` |
|
|
605
|
+
| `nexus channel connection create` | `client.channels.createConnection()` |
|
|
606
|
+
| `nexus channel whatsapp-sender create` | `client.channels.createWhatsAppSender({ ... })` |
|
|
603
607
|
|
|
604
608
|
> **Full SDK documentation:** See [@agent-nexus/sdk README](../sdk/README.md)
|
|
605
609
|
|
|
@@ -704,11 +708,11 @@ sudo npm install -g @agent-nexus/cli@latest
|
|
|
704
708
|
|
|
705
709
|
## Configuration Files
|
|
706
710
|
|
|
707
|
-
| File
|
|
708
|
-
|
|
709
|
-
| `~/.nexus-mcp/config.json`
|
|
710
|
-
| `~/.nexus-mcp/version-check.json` | Update check cache (auto-managed, checked once/day)
|
|
711
|
-
| `.nexusrc`
|
|
711
|
+
| File | Purpose | Permissions |
|
|
712
|
+
| --------------------------------- | ------------------------------------------------------------- | ----------- |
|
|
713
|
+
| `~/.nexus-mcp/config.json` | Profiles with API keys and base URLs | `0600` |
|
|
714
|
+
| `~/.nexus-mcp/version-check.json` | Update check cache (auto-managed, checked once/day) | `0600` |
|
|
715
|
+
| `.nexusrc` | Directory-level profile pinning (created by `nexus auth pin`) | — |
|
|
712
716
|
|
|
713
717
|
The `~/.nexus-mcp/` directory is created with `0700` permissions. This path is shared with the [`@nexus/mcp-server`](../mcp-server/) package.
|
|
714
718
|
|