@elevasis/sdk 0.5.13 → 0.5.15

package/reference/cli.mdx

@@ -1,505 +1,568 @@
----
-title: CLI Reference
-description: Full reference for every elevasis-sdk CLI command -- scaffold, validate, deploy, execute, and inspect resources
-loadWhen: "Running CLI operations"
----
-
-The `elevasis-sdk` CLI is the primary interface for working with your Elevasis SDK project. Install it as part of `@elevasis/sdk` and use it to scaffold projects, validate resource definitions, deploy to the platform, and inspect execution history.
-
-**Installation:**
-
-```bash
-pnpm add @elevasis/sdk
-```
-
-After installation, the `elevasis-sdk` binary is available in your project's `node_modules/.bin/`. Most commands require `ELEVASIS_API_KEY` to be set in your environment or a `.env` file.
-
----
-
-## elevasis-sdk init
-
-Scaffold a new Elevasis SDK project in the specified directory.
-
-**Synopsis:**
-
-```
-elevasis-sdk init [directory]
-```
-
-**Behavior:**
-
-- Derives the organization slug from the directory name
-- Checks for file conflicts before writing any files
-- Scaffolds project structure including `src/index.ts`, `elevasis.config.ts`, `package.json`, `tsconfig.json`, and a `CLAUDE.md` with CLI reference and SDK patterns
-- Non-interactive: all values are derived automatically
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| (none) | Uses current directory if no argument is provided |
-
-**Example:**
-
-```bash
-elevasis-sdk init my-project
-```
-
-You can also run `init` without a global install using `pnpm dlx`:
-
-```bash
-pnpm dlx @elevasis/sdk init my-project
-```
-
-```
-  Scaffolding my-project/...
-
-  Created 23 files.
-
-  Next steps:
-    cd my-project
-    pnpm install
-    elevasis-sdk check
-```
-
----
-
-## elevasis-sdk check
-
-Validate all resource definitions in your project without deploying.
-
-**Synopsis:**
-
-```
-elevasis-sdk check
-```
-
-**Behavior:**
-
-- Imports your `src/index.ts` and runs it through `ResourceRegistry` validation
-- Catches the same errors that the platform catches at deploy time:
-  - Duplicate `resourceId` within the organization
-  - Invalid model configuration (temperature and token bounds)
-  - `ExecutionInterface` form fields not matching `inputSchema`
-  - Broken workflow step chains (`next` referencing non-existent steps)
-  - Relationship declarations referencing non-existent resources
-- Exits with code 0 on success, code 1 on validation failure
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--api-url <url>` | Override the API base URL |
-
-**Example output (success):**
-
-```
-$ elevasis-sdk check
-
-  Validating...    done (4 resources, 0 errors)
-```
-
-**Example output (failure):**
-
-```
-$ elevasis-sdk check
-
-  Validating...
-    ERROR  Duplicate resource ID 'onboard-client' in organization 'Acme Corp'
-    ERROR  Workflow step 'send-email' references non-existent next step 'notify'
-
-  2 errors.
-```
-
----
-
-## elevasis-sdk deploy
-
-Bundle your project with esbuild and deploy it to the Elevasis platform.
-
-**Synopsis:**
-
-```
-elevasis-sdk deploy
-```
-
-**Behavior:**
-
-- Authenticates with `ELEVASIS_API_KEY` and resolves your organization name
-- Runs the same `ResourceRegistry` validation as `elevasis-sdk check`
-- Bundles your `src/index.ts` and all dependencies into a single self-contained JS file (`dist/bundle.js`, approximately 50-200 KB)
-- Uploads the bundle plus resource metadata to `POST /api/external/deploy`
-- Streams deploy status and prints the result
-- Resources are live immediately after a successful deploy
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--api-url <url>` | Override the API base URL (default: production) |
-| `--prod` | Force production target, overriding `NODE_ENV=development` (internal use) |
-
-**Environment variables:**
-
-| Variable | Description |
-| -------- | ----------- |
-| `ELEVASIS_API_KEY` | Required. Your `sk_...` API key |
-| `ELEVASIS_API_URL` | Optional. Override the API base URL |
-
-**Example output (success):**
-
-```
-$ elevasis-sdk deploy
-
-  Authenticating...          done (acme-corp)
-  Validating...              done (4 resources, 0 errors)
-  Bundling...                done (142 KB)
-  Uploading...               done
-
-  Deployed! 4 resources live.
-  Deployment: deploy_abc123
-```
-
-**Example output (validation failure):**
-
-```
-$ elevasis-sdk deploy
-
-  Authenticating...          done (acme-corp)
-  Validating...
-    ERROR  Duplicate resource ID 'onboard-client' in organization 'Acme Corp'
-    ERROR  Workflow step 'send-email' references non-existent next step 'notify'
-
-  2 errors. Deploy aborted.
-```
-
----
-
-## elevasis-sdk exec
-
-Execute a deployed resource by ID.
-
-**Synopsis:**
-
-```
-elevasis-sdk exec <resource> --input '{...}'
-```
-
-**Behavior:**
-
-- Executes the named resource synchronously by default and streams the result
-- Use `--async` to return an `executionId` immediately and poll for completion
-- `--input` accepts a JSON string matching the resource's `inputSchema`
-- Organization is derived from your API key -- no org prefix needed
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--input <json>` | JSON input matching the resource's input schema |
-| `--async` | Execute asynchronously, return execution ID immediately |
-| `--json` | Output raw JSON instead of formatted display |
-| `--api-url <url>` | Override the API base URL |
-
-**Example:**
-
-```bash
-elevasis-sdk exec onboard-client --input '{"clientName": "Jane", "email": "jane@example.com"}'
-```
-
-```
-  Executing onboard-client...
-
-  Status:   completed
-  Duration: 1.4s
-
-  Output:
-  {
-    "success": true,
-    "clientId": "client_1708521600000",
-    "welcomeEmailSent": true
-  }
-```
-
-**Async example:**
-
-```bash
-elevasis-sdk exec onboard-client --input '{"clientName": "Jane"}' --async
-```
-
-```
-  Execution started: exec_550e8400
-  Poll with: elevasis-sdk execution onboard-client exec_550e8400
-```
-
----
-
-## elevasis-sdk resources
-
-List all deployed resources for your organization.
-
-**Synopsis:**
-
-```
-elevasis-sdk resources
-```
-
-**Behavior:**
-
-- Lists all resources registered to your organization on the platform
-- In production, only `status: 'prod'` resources are shown
-- Displays resource ID, type, name, and status
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--json` | Output raw JSON |
-| `--api-url <url>` | Override the API base URL |
-
-**Example output:**
-
-```
-$ elevasis-sdk resources
-
-  onboard-client    workflow   Onboard Client       prod
-  send-report       workflow   Send Weekly Report   prod
-  email-assistant   agent      Email Assistant      prod
-  support-bot       agent      Support Bot          dev
-```
-
----
-
-## elevasis-sdk executions
-
-View execution history for a resource.
-
-**Synopsis:**
-
-```
-elevasis-sdk executions [resource]
-```
-
-**Behavior:**
-
-- Lists recent executions for the specified resource
-- If `resource` is omitted, lists executions across all resources
-- Supports filtering by status and limiting result count
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--limit <n>` | Maximum number of executions to return (default: 20) |
-| `--status <status>` | Filter by status: `running`, `completed`, `failed`, `cancelled` |
-| `--json` | Output raw JSON |
-| `--api-url <url>` | Override the API base URL |
-
-**Example:**
-
-```bash
-elevasis-sdk executions onboard-client --limit 5
-```
-
-```
-  exec_abc001   completed   2026-02-25 14:32:01   1.2s
-  exec_abc002   completed   2026-02-25 13:18:44   0.9s
-  exec_abc003   failed      2026-02-25 12:05:22   0.3s
-  exec_abc004   completed   2026-02-24 17:51:09   1.8s
-  exec_abc005   completed   2026-02-24 16:30:55   1.1s
-```
-
----
-
-## elevasis-sdk execution
-
-View full detail for a single execution.
-
-**Synopsis:**
-
-```
-elevasis-sdk execution <resource> <id>
-```
-
-**Behavior:**
-
-- Shows the complete execution record: input, output, logs, duration, and error (if any)
-- Use `--json` to get the raw JSON response for programmatic use
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--json` | Output raw JSON |
-| `--api-url <url>` | Override the API base URL |
-
-**Example:**
-
-```bash
-elevasis-sdk execution onboard-client exec_abc001
-```
-
-```
-  Resource:   onboard-client
-  Status:     completed
-  Started:    2026-02-25 14:32:01
-  Duration:   1.2s
-
-  Input:
-  {
-    "clientName": "Jane",
-    "email": "jane@example.com"
-  }
-
-  Output:
-  {
-    "success": true,
-    "clientId": "client_1708521600000",
-    "welcomeEmailSent": true
-  }
-
-  Logs:
-  [14:32:01.123]  Starting onboard-client workflow
-  [14:32:01.456]  Created client record
-  [14:32:01.891]  Welcome email sent to jane@example.com
-```
-
----
-
-## elevasis-sdk deployments
-
-List all deployments for your organization.
-
-**Synopsis:**
-
-```
-elevasis-sdk deployments
-```
-
-**Behavior:**
-
-- Shows deployment history with status, timestamp, and resource count
-- Active deployment is marked; previous deployments show as `stopped`
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--json` | Output raw JSON |
-| `--api-url <url>` | Override the API base URL |
-
-**Example output:**
-
-```
-$ elevasis-sdk deployments
-
-  deploy_abc123   active    2026-02-25 14:00:00   4 resources
-  deploy_abc122   stopped   2026-02-24 09:30:00   3 resources
-  deploy_abc121   stopped   2026-02-23 11:15:00   3 resources
-```
-
----
-
-## elevasis-sdk describe
-
-Show the definition of a deployed resource.
-
-**Synopsis:**
-
-```
-elevasis-sdk describe <resource>
-```
-
-**Behavior:**
-
-- Displays resource metadata: name, type, description, status, and domains
-- Shows the full `inputSchema` and `outputSchema` as JSON
-- Type is color-coded: yellow for workflows, magenta for agents
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--json` | Output raw JSON response |
-| `--api-url <url>` | Override the API base URL |
-
-**Example:**
-
-```bash
-elevasis-sdk describe onboard-client
-```
-
-```
-  onboard-client  [workflow]
-
-  Name:         Onboard Client
-  Description:  Creates a client record and sends a welcome email
-  Status:       prod
-  Domains:      crm, email
-
-  Input Schema:
-  {
-    "type": "object",
-    "properties": {
-      "clientName": { "type": "string" },
-      "email": { "type": "string", "format": "email" }
-    },
-    "required": ["clientName", "email"]
-  }
-```
-
----
-
-## elevasis-sdk env
-
-Manage environment variables for your project.
-
-**Synopsis:**
-
-```
-elevasis-sdk env list
-elevasis-sdk env set <key> <value>
-elevasis-sdk env remove <key>
-```
-
-**Behavior:**
-
-- `list` -- display all environment variables configured for the project
-- `set` -- add or update an environment variable
-- `remove` -- delete an environment variable
-
-**Flags:**
-
-| Flag | Description |
-| ---- | ----------- |
-| `--api-url <url>` | Override the API base URL |
-
-**Examples:**
-
-```bash
-elevasis-sdk env list
-elevasis-sdk env set OPENAI_API_KEY sk-proj-***
-elevasis-sdk env remove OPENAI_API_KEY
-```
-
----
-
-## Global Flags
-
-These flags are accepted by all commands:
-
-| Flag | Description |
-| ---- | ----------- |
-| `--api-url <url>` | Override the API base URL. Priority: flag > `ELEVASIS_API_URL` env var > `NODE_ENV`-based default |
-| `--json` | Output raw JSON (available on most commands) |
-
-**API base URL resolution:**
-
-- Production (default): `https://api.elevasis.io`
-- Development (`NODE_ENV=development`): `http://localhost:<port>`
-- Override: set `ELEVASIS_API_URL` or pass `--api-url`
-- Force production: pass `--prod` on `deploy` (overrides `NODE_ENV=development`)
-
----
-
-**Last Updated:** 2026-03-03
+---
+title: CLI Reference
+description: Full reference for every elevasis-sdk CLI command -- scaffold, validate, deploy, execute, and inspect resources
+loadWhen: "Running CLI operations"
+---
+
+The `elevasis-sdk` CLI is the primary interface for working with your Elevasis SDK project. Install it as part of `@elevasis/sdk` and use it to scaffold projects, validate resource definitions, deploy to the platform, and inspect execution history.
+
+**Installation:**
+
+```bash
+pnpm add @elevasis/sdk
+```
+
+After installation, the `elevasis-sdk` binary is available in your project's `node_modules/.bin/`. Most commands require `ELEVASIS_PLATFORM_KEY` to be set in your environment or a `.env` file.
+
+---
+
+## elevasis-sdk init
+
+Scaffold a new Elevasis SDK project in the specified directory.
+
+**Synopsis:**
+
+```
+elevasis-sdk init [directory]
+```
+
+**Behavior:**
+
+- Derives the organization slug from the directory name
+- Checks for file conflicts before writing any files
+- Scaffolds project structure including `src/index.ts`, `elevasis.config.ts`, `package.json`, `tsconfig.json`, and a `CLAUDE.md` with CLI reference and SDK patterns
+- Non-interactive: all values are derived automatically
+
+**Flags:**
+
+| Flag   | Description                                       |
+| ------ | ------------------------------------------------- |
+| (none) | Uses current directory if no argument is provided |
+
+**Example:**
+
+```bash
+elevasis-sdk init my-project
+```
+
+You can also run `init` without a global install using `pnpm dlx`:
+
+```bash
+pnpm dlx @elevasis/sdk init my-project
+```
+
+```
+  Scaffolding my-project/...
+
+  Created 30 files.
+
+  Next steps:
+    cd my-project
+    pnpm install
+    elevasis-sdk check
+```
+
+---
+
+## elevasis-sdk update
+
+Update managed project files to the latest template version.
+
+**Synopsis:**
+
+```
+elevasis-sdk update [--ui]
+```
+
+**Behavior:**
+
+- Reads `elevasis.config.ts` to get the current `templateVersion` and compares it against the latest template version
+- If already up to date (and no `--ui` flag), exits early with a success message
+- For each managed file:
+  - Missing files are written directly
+  - `.gitignore` uses append-only merge -- new entries are added, existing entries are never removed
+  - `elevasis.config.ts` gets only its `templateVersion` field updated
+  - `CLAUDE.md` uses section-aware merge -- SDK-owned sections are replaced with the latest template, user-added sections are preserved
+  - All other managed files are compared against the template and flagged for review if they differ
+- Pass `--ui` to scaffold a Vite + React UI app in `ui/` (can be combined with a version update or run independently)
+
+**Flags:**
+
+| Flag   | Description                             |
+| ------ | --------------------------------------- |
+| `--ui` | Add a Vite + React UI scaffold in `ui/` |
+
+**Example output (version update):**
+
+```
+$ elevasis-sdk update
+
+  Updated @elevasis/sdk template v24 -> v27
+
+  Added:
+    .env.example
+
+  Appended to .gitignore:
+    ui/dist
+
+  Needs agent review:
+    tsconfig.json (differs from template)
+
+  CLAUDE.md sections:
+    updated: Commands
+    updated: Skills
+    preserved: Custom Workflows
+
+  Run /meta update in Claude Code to merge flagged files.
+  Or run /meta fix to verify and repair the full framework.
+```
+
+**Example output (already up to date):**
+
+```
+$ elevasis-sdk update
+
+  Project is up to date (template version 27)
+```
+
+---
+
+## elevasis-sdk check
+
+Validate all resource definitions in your project without deploying.
+
+**Synopsis:**
+
+```
+elevasis-sdk check
+```
+
+**Behavior:**
+
+- Imports your `src/index.ts` and runs it through `ResourceRegistry` validation
+- Catches the same errors that the platform catches at deploy time:
+  - Duplicate `resourceId` within the organization
+  - Invalid model configuration (temperature and token bounds)
+  - `ExecutionInterface` form fields not matching `inputSchema`
+  - Broken workflow step chains (`next` referencing non-existent steps)
+  - Relationship declarations referencing non-existent resources
+- Exits with code 0 on success, code 1 on validation failure
+
+**Flags:**
+
+| Flag                | Description               |
+| ------------------- | ------------------------- |
+| `--api-url <url>` | Override the API base URL |
+
+**Example output (success):**
+
+```
+$ elevasis-sdk check
+
+  Validating...    done (4 resources, 0 errors)
+```
+
+**Example output (failure):**
+
+```
+$ elevasis-sdk check
+
+  Validating...
+    ERROR  Duplicate resource ID 'onboard-client' in organization 'Acme Corp'
+    ERROR  Workflow step 'send-email' references non-existent next step 'notify'
+
+  2 errors.
+```
+
+---
+
+## elevasis-sdk deploy
+
+Bundle your project with esbuild and deploy it to the Elevasis platform.
+
+**Synopsis:**
+
+```
+elevasis-sdk deploy
+```
+
+**Behavior:**
+
+- Authenticates with `ELEVASIS_PLATFORM_KEY` and resolves your organization name
+- Runs the same `ResourceRegistry` validation as `elevasis-sdk check`
+- Bundles your `src/index.ts` and all dependencies into a single self-contained JS file (`dist/bundle.js`, approximately 50-200 KB)
+- Uploads the bundle plus resource metadata to `POST /api/external/deploy`
+- Streams deploy status and prints the result
+- Resources are live immediately after a successful deploy
+
+**Flags:**
+
+| Flag                | Description                                                               |
+| ------------------- | ------------------------------------------------------------------------- |
+| `--api-url <url>` | Override the API base URL (default: production)                           |
+| `--prod`            | Force production target, overriding `NODE_ENV=development` (internal use) |
+
+**Environment variables:**
+
+| Variable                | Description                         |
+| ----------------------- | ----------------------------------- |
+| `ELEVASIS_PLATFORM_KEY` | Required. Your `sk_...` API key     |
+| `ELEVASIS_API_URL`      | Optional. Override the API base URL |
+
+**Example output (success):**
+
+```
+$ elevasis-sdk deploy
+
+  Authenticating...          done (acme-corp)
+  Validating...              done (4 resources, 0 errors)
+  Bundling...                done (142 KB)
+  Uploading...               done
+
+  Deployed! 4 resources live.
+  Deployment: deploy_abc123
+```
+
+**Example output (validation failure):**
+
+```
+$ elevasis-sdk deploy
+
+  Authenticating...          done (acme-corp)
+  Validating...
+    ERROR  Duplicate resource ID 'onboard-client' in organization 'Acme Corp'
+    ERROR  Workflow step 'send-email' references non-existent next step 'notify'
+
+  2 errors. Deploy aborted.
+```
+
+---
+
+## elevasis-sdk exec
+
+Execute a deployed resource by ID.
+
+**Synopsis:**
+
+```
+elevasis-sdk exec <resource> --input '{...}'
+```
+
+**Behavior:**
+
+- Executes the named resource synchronously by default and streams the result
+- Use `--async` to return an `executionId` immediately and poll for completion
+- `--input` accepts a JSON string matching the resource's `inputSchema`
+- Organization is derived from your API key -- no org prefix needed
+
+**Flags:**
+
+| Flag                | Description                                             |
+| ------------------- | ------------------------------------------------------- |
+| `--input <json>`  | JSON input matching the resource's input schema         |
+| `--async`           | Execute asynchronously, return execution ID immediately |
+| `--json`            | Output raw JSON instead of formatted display            |
+| `--api-url <url>` | Override the API base URL                               |
+
+**Example:**
+
+```bash
+elevasis-sdk exec onboard-client --input '{"clientName": "Jane", "email": "jane@example.com"}'
+```
+
+```
+  Executing onboard-client...
+
+  Status:   completed
+  Duration: 1.4s
+
+  Output:
+  {
+    "success": true,
+    "clientId": "client_1708521600000",
+    "welcomeEmailSent": true
+  }
+```
+
+**Async example:**
+
+```bash
+elevasis-sdk exec onboard-client --input '{"clientName": "Jane"}' --async
+```
+
+```
+  Execution started: exec_550e8400
+  Poll with: elevasis-sdk execution onboard-client exec_550e8400
+```
+
+---
+
+## elevasis-sdk resources
+
+List all deployed resources for your organization.
+
+**Synopsis:**
+
+```
+elevasis-sdk resources
+```
+
+**Behavior:**
+
+- Lists all resources registered to your organization on the platform
+- In production, only `status: 'prod'` resources are shown
+- Displays resource ID, type, name, and status
+
+**Flags:**
+
+| Flag                | Description               |
+| ------------------- | ------------------------- |
+| `--json`            | Output raw JSON           |
+| `--api-url <url>` | Override the API base URL |
+
+**Example output:**
+
+```
+$ elevasis-sdk resources
+
+  onboard-client    workflow   Onboard Client       prod
+  send-report       workflow   Send Weekly Report   prod
+  email-assistant   agent      Email Assistant      prod
+  support-bot       agent      Support Bot          dev
+```
+
+---
+
+## elevasis-sdk executions
+
+View execution history for a resource.
+
+**Synopsis:**
+
+```
+elevasis-sdk executions [resource]
+```
+
+**Behavior:**
+
+- Lists recent executions for the specified resource
+- If `resource` is omitted, lists executions across all resources
+- Supports filtering by status and limiting result count
+
+**Flags:**
+
+| Flag                  | Description                                                     |
+| --------------------- | --------------------------------------------------------------- |
+| `--limit <n>`       | Maximum number of executions to return (default: 20)            |
+| `--status <status>` | Filter by status: `running`, `completed`, `failed`, `cancelled` |
+| `--json`              | Output raw JSON                                                 |
+| `--api-url <url>`   | Override the API base URL                                       |
+
+**Example:**
+
+```bash
+elevasis-sdk executions onboard-client --limit 5
+```
+
+```
+  exec_abc001   completed   2026-02-25 14:32:01   1.2s
+  exec_abc002   completed   2026-02-25 13:18:44   0.9s
+  exec_abc003   failed      2026-02-25 12:05:22   0.3s
+  exec_abc004   completed   2026-02-24 17:51:09   1.8s
+  exec_abc005   completed   2026-02-24 16:30:55   1.1s
+```
+
+---
+
+## elevasis-sdk execution
+
+View full detail for a single execution.
+
+**Synopsis:**
+
+```
+elevasis-sdk execution <resource> <id>
+```
+
+**Behavior:**
+
+- Shows the complete execution record: input, output, logs, duration, and error (if any)
+- Use `--json` to get the raw JSON response for programmatic use
+
+**Flags:**
+
+| Flag                | Description               |
+| ------------------- | ------------------------- |
+| `--json`            | Output raw JSON           |
+| `--api-url <url>` | Override the API base URL |
+
+**Example:**
+
+```bash
+elevasis-sdk execution onboard-client exec_abc001
+```
+
+```
+  Resource:   onboard-client
+  Status:     completed
+  Started:    2026-02-25 14:32:01
+  Duration:   1.2s
+
+  Input:
+  {
+    "clientName": "Jane",
+    "email": "jane@example.com"
+  }
+
+  Output:
+  {
+    "success": true,
+    "clientId": "client_1708521600000",
+    "welcomeEmailSent": true
+  }
+
+  Logs:
+  [14:32:01.123]  Starting onboard-client workflow
+  [14:32:01.456]  Created client record
+  [14:32:01.891]  Welcome email sent to jane@example.com
+```
+
+---
+
+## elevasis-sdk deployments
+
+List all deployments for your organization.
+
+**Synopsis:**
+
+```
+elevasis-sdk deployments
+```
+
+**Behavior:**
+
+- Shows deployment history with status, timestamp, and resource count
+- Active deployment is marked; previous deployments show as `stopped`
+
+**Flags:**
+
+| Flag                | Description               |
+| ------------------- | ------------------------- |
+| `--json`            | Output raw JSON           |
+| `--api-url <url>` | Override the API base URL |
+
+**Example output:**
+
+```
+$ elevasis-sdk deployments
+
+  deploy_abc123   active    2026-02-25 14:00:00   4 resources
+  deploy_abc122   stopped   2026-02-24 09:30:00   3 resources
+  deploy_abc121   stopped   2026-02-23 11:15:00   3 resources
+```
+
+---
+
+## elevasis-sdk describe
+
+Show the definition of a deployed resource.
+
+**Synopsis:**
+
+```
+elevasis-sdk describe <resource>
+```
+
+**Behavior:**
+
+- Displays resource metadata: name, type, description, status, and domains
+- Shows the full `inputSchema` and `outputSchema` as JSON
+- Type is color-coded: yellow for workflows, magenta for agents
+
+**Flags:**
+
+| Flag                | Description               |
+| ------------------- | ------------------------- |
+| `--json`            | Output raw JSON response  |
+| `--api-url <url>` | Override the API base URL |
+
+**Example:**
+
+```bash
+elevasis-sdk describe onboard-client
+```
+
+```
+  onboard-client  [workflow]
+
+  Name:         Onboard Client
+  Description:  Creates a client record and sends a welcome email
+  Status:       prod
+  Domains:      crm, email
+
+  Input Schema:
+  {
+    "type": "object",
+    "properties": {
+      "clientName": { "type": "string" },
+      "email": { "type": "string", "format": "email" }
+    },
+    "required": ["clientName", "email"]
+  }
+```
+
+---
+
+## elevasis-sdk env
+
+Manage environment variables for your project.
+
+**Synopsis:**
+
+```
+elevasis-sdk env list
+elevasis-sdk env set <key> <value>
+elevasis-sdk env remove <key>
+```
+
+**Behavior:**
+
+- `list` -- display all environment variables configured for the project
+- `set` -- add or update an environment variable
+- `remove` -- delete an environment variable
+
+**Flags:**
+
+| Flag                | Description               |
+| ------------------- | ------------------------- |
+| `--api-url <url>` | Override the API base URL |
+
+**Examples:**
+
+```bash
+elevasis-sdk env list
+elevasis-sdk env set OPENAI_API_KEY sk-proj-***
+elevasis-sdk env remove OPENAI_API_KEY
+```
+
+---
+
+## Global Flags
+
+These flags are accepted by all commands:
+
+| Flag                | Description                                                                                         |
+| ------------------- | --------------------------------------------------------------------------------------------------- |
+| `--api-url <url>` | Override the API base URL. Priority: flag > `ELEVASIS_API_URL` env var > `NODE_ENV`-based default |
+| `--json`            | Output raw JSON (available on most commands)                                                        |
+
+**API base URL resolution:**
+
+- Production (default): `https://api.elevasis.io`
+- Development (`NODE_ENV=development`): `http://localhost:<port>`
+- Override: set `ELEVASIS_API_URL` or pass `--api-url`
+- Force production: pass `--prod` on `deploy` (overrides `NODE_ENV=development`)
+
+---
+
+**Last Updated:** 2026-03-08