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. |