CLI reference
The edge-connector CLI manages authentication, tool code generation, bundle packaging and upload, bundle assignment, and cloud connector lifecycle. Running edge-connector with no arguments opens an interactive menu covering the same operations.
Authenticate the CLI against your nara organization.
edge-connector auth| Flag | Description |
|---|---|
-t, --token <token> |
Provide a JWT directly, or a path to a token file. Must be unexpired and contain org info. |
-i, --interactive |
Interactive prompt (default). |
-b, --browser |
Device-code browser flow. |
--token and --browser cannot be combined.
generate
Section titled “generate”Alias: g. Scaffolds TypeScript implementation stubs for your organization’s EDGE tools. Requires authentication; fetches tool definitions from the Tool RPC server.
edge-connector generate -t myTool| Flag | Description |
|---|---|
-l, --language |
Target language (typescript only). |
-t, --tool <name> |
Generate a specific tool only. |
-o, --output <path> |
Output directory (default ./custom-implementations). |
-i, --interactive |
Interactive prompt. |
package
Section titled “package”Build and package tool implementations into a bundle archive. Each tool must live in its own file under tools/ — a single index.ts entrypoint is no longer supported. The output is edge-bundle-<orgId>-<timestamp>.tgz containing manifest.json and dist/.
edge-connector package| Flag | Description |
|---|---|
-i, --implementations <path> |
Implementations directory (default ./custom-implementations). |
-o, --out <dir> |
Output directory (default ./artifacts). |
--no-build |
Skip the build step. |
upload
Section titled “upload”Package (unless -f is given) and upload a bundle to the platform. Maximum bundle size is 50 MB. A successful upload updates currentBundleId.
edge-connector upload| Flag | Description |
|---|---|
-f, --file <tgz> |
Upload an existing bundle archive. |
-i, --interactive |
Interactive prompt. |
--no-build |
Skip the build step. |
--api <url> |
Override the platform API URL. |
--name <text> |
Bundle name. |
--notes <text> |
Bundle notes. |
bundle
Section titled “bundle”Manage tool bundles. All subcommands accept --api <url>.
| Subcommand | Description |
|---|---|
bundle list |
List your organization’s bundles. |
bundle checkout [id] |
Check out a bundle locally; --new starts a fresh bundle. |
bundle status |
Show the currently checked-out bundle. |
bundle tools |
List tools in the current bundle. |
bundle ref <tool> --version <n> |
Reference a server-hosted tool version instead of local source. |
bundle set-default <id> |
Set the organization’s default bundle. |
bundle assign <id> --deployment <id> [--version <n>] |
Assign a bundle to a deployment, optionally pinned to a version. |
bundle rename <id> <name> |
Rename a bundle. |
Manage your organization’s cloud connector (via /api/edge/cloud/*).
| Subcommand | Description |
|---|---|
cloud provision --env <dev|stage|prod> |
Provision a cloud connector. |
cloud start |
Start the cloud connector. |
cloud stop |
Stop the cloud connector. |
cloud status |
Show connector status. |
cloud force-complete |
Force a pending operation to complete. |
cloud delete |
Delete the cloud connector. |