CLI reference
Generated command, argument, flag, and example reference for relkit 0.8.4.
For guided setup and everyday workflows, start with the CLI module or follow Create and build an API. This page lists exact command arguments and options.
The command model below is shared with the Effect CLI runtime, so nested help and this page cannot drift.
relkit <command>
Convention-first TypeScript application framework
| Option | Value | Description |
|---|---|---|
| –json | boolean | Emit machine-readable output |
Examples
relkit — Convention-first TypeScript application framework
relkit create [name]
Create a new RELKIT application
| Argument | Value | Description |
|---|---|---|
| name | optional | npm package and application name |
| Option | Value | Description |
|---|---|---|
| –template | minimal, api, agent, fullstack | Candidate template; certified tuples only |
| –cloud | aws, none | Candidate cloud selection; certified tuples only |
| –deploy | pulumi, none | Candidate deployment selection; certified tuples only |
| –jobs | inngest-docker, effect-mq-docker, trigger-docker | Candidate jobs service; certified native tuples only |
| –directory | string | Destination directory |
| –install | boolean | Install generated project setup |
| –no-install | boolean | No install generated project setup |
| –git | boolean | Git generated project setup |
| –no-git | boolean | No git generated project setup |
| –examples | boolean | Examples generated project setup |
| –no-examples | boolean | No examples generated project setup |
| –force-empty-directory | boolean | Allow an existing empty destination |
Examples
relkit create — Create a new RELKIT application
relkit add <kind>
Add a compile-ready artifact
Examples
relkit add — Add a compile-ready artifact
relkit add service [name]
Create a domain service
| Argument | Value | Description |
|---|---|---|
| name | optional | Service name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –full | boolean | Create the complete deterministic domain bundle; exclusive with –include |
| –include | function, task, error, event, event-function, job, cache, bucket, tool, prompt, agent, constants, route | Artifact kind to include; repeatable |
Examples
relkit add service — Create a domain service
relkit add function [name]
Create a callable function
| Argument | Value | Description |
|---|---|---|
| name | optional | Function name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –internal | boolean | Keep the artifact out of the public service API |
Examples
relkit add function — Create a callable function
relkit add task [name]
Create a task artifact
| Argument | Value | Description |
|---|---|---|
| name | optional | Task name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –version | string | Task semantic version (default: 1) |
| –execution | durable, retryable | Task execution model (default: durable) |
Examples
relkit add task — Create a task artifact
relkit add error [name]
Create an internal typed error
| Argument | Value | Description |
|---|---|---|
| name | optional | Error name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
Examples
relkit add error — Create an internal typed error
relkit add event [name]
Create an event contract
| Argument | Value | Description |
|---|---|---|
| name | optional | Event name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –internal | boolean | Keep the artifact out of the public service API |
| –profile | string | Compatible profile name; otherwise reuse a default/unique profile or scaffold a local profile |
Examples
relkit add event — Create an event contract
relkit add event-function [name]
Create an event-only function
| Argument | Value | Description |
|---|---|---|
| name | optional | Event function name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –event | string | Event ID, binding, or filename |
| –delivery | transient, durable | Delivery mode (default: durable) |
| –profile | string | Compatible profile name; otherwise reuse a default/unique profile or scaffold a local profile |
Examples
relkit add event-function — Create an event-only function
relkit add job [name]
Create an unscheduled single-attempt job
| Argument | Value | Description |
|---|---|---|
| name | optional | Job name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –target | string | Task ID; legacy callable function targets remain readable |
| –profile | string | Compatible profile name; otherwise reuse a default/unique profile or scaffold a local profile |
Examples
relkit add job — Create an unscheduled single-attempt job
relkit add cache [name]
Create a cache descriptor and compatible profile
| Argument | Value | Description |
|---|---|---|
| name | optional | Cache name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –profile | string | Compatible profile name; otherwise reuse a default/unique profile or scaffold a local profile |
| –provider | redis, cloudflare-kv | Cache provider |
| –source | docker, connected, aws | Provider source |
Examples
relkit add cache — Create a cache descriptor and compatible profile
relkit add bucket [name]
Create a bucket descriptor and compatible profile
| Argument | Value | Description |
|---|---|---|
| name | optional | Bucket name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –profile | string | Compatible profile name; otherwise reuse a default/unique profile or scaffold a local profile |
| –provider | s3, cloudflare-r2 | Bucket provider |
| –source | docker, connected, aws | Provider source |
Examples
relkit add bucket — Create a bucket descriptor and compatible profile
relkit add tool [name]
Expose a callable function as an agent tool
| Argument | Value | Description |
|---|---|---|
| name | optional | Tool name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –target | string | Existing callable function; exclusive with –create-function |
| –create-function | string | Create a callable function; exclusive with –target |
| –side-effect | none, read, write, external | Tool side-effect class (default: read) |
| –approval | never, on-write, always | Tool approval policy (default: never) |
Examples
relkit add tool — Expose a callable function as an agent tool
relkit add prompt [name]
Create a reusable prompt
| Argument | Value | Description |
|---|---|---|
| name | optional | Prompt name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –text | string | Prompt text; repeatable |
Examples
relkit add prompt — Create a reusable prompt
relkit add agent [name]
Create an agent with a model, tools, and instructions
| Argument | Value | Description |
|---|---|---|
| name | optional | Agent name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –model | string | Existing native model profile; omitted uses an offline model |
| –tool | string | Tool ID, binding, or filename; repeatable |
| –prompt | string | Service prompt ID, binding, or filename; exclusive with –instructions |
| –instructions | string | Inline instructions; exactly one of –prompt or –instructions is required |
Examples
relkit add agent — Create an agent with a model, tools, and instructions
relkit add constants [name]
Create a constants descriptor
| Argument | Value | Description |
|---|---|---|
| name | optional | Constants name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
Examples
relkit add constants — Create a constants descriptor
relkit add route [path]
Create a route or service route
| Argument | Value | Description |
|---|---|---|
| path | optional | URL route path |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –mode | route, service-route | Required headlessly: raw GET route or public service-member mappings |
| –map | key=value | METHOD=member mapping; repeatable |
Examples
relkit add route — Create a route or service route
relkit add middleware [name]
Create pass-through route middleware
| Argument | Value | Description |
|---|---|---|
| name | optional | Middleware name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –path | string | Validated middleware route scope |
Examples
relkit add middleware — Create pass-through route middleware
relkit add transform [name]
Create a string request transform
| Argument | Value | Description |
|---|---|---|
| name | optional | Transform name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
Examples
relkit add transform — Create a string request transform
relkit add database
Create the singleton Drizzle database service
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –orm | drizzle | Database ORM |
| –dialect | sqlite, postgresql, mysql | Database dialect (default: sqlite) |
Examples
relkit add database — Create the singleton Drizzle database service
relkit add auth
Create Better Auth and its catch-all route
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –service | string | Existing generic service for domain artifacts or service routes; exclusive with –create-service |
| –create-service | string | Create and use a new generic service for a domain artifact or service route |
| –no-install | boolean | Do not install newly required packages |
| –adapter | better-auth | Authentication adapter |
| –database-dialect | sqlite, postgresql, mysql | Database dialect when one must be created (default: sqlite) |
| –base-path | string | Auth base path (default: /api/auth) |
Examples
relkit add auth — Create Better Auth and its catch-all route
relkit add inspector
Enable the inspector bridge and its local UI
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –no-install | boolean | Do not install @relkit/inspector |
Examples
relkit add inspector — Enable the inspector bridge and its local UI
relkit migrate <command>
Preview and apply source layout migrations
Examples
relkit migrate — Preview and apply source layout migrations
relkit migrate layout
Move flat services into src/services with guarded rollback
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –write | boolean | Validate and apply; stop development first |
| –rollback | string | Restore a local migration receipt; conflicts refuse overwrite |
Examples
relkit migrate layout — Move flat services into src/services with guarded rollback
relkit db <command>
Manage application database migrations
Examples
relkit db — Manage application database migrations
relkit db migrate
Apply pending migrations using the application’s installed tools
| Option | Value | Description |
|---|---|---|
| –config | string | Application Drizzle config; defaults to drizzle.config.ts. Relative paths use the application root |
Examples
relkit db migrate — Apply pending migrations using the application’s installed tools
relkit dev
Run the app and its selected development features
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –prepare | boolean | Prepare a validated dev snapshot and exit without a server |
| –port | integer | Application port |
| –inspector-port | integer | Retired; configure inspector.connection.port, or run relkit inspector –port |
| –local | on, off | Start required local services |
| –log-level | all, trace, debug, info, warn, error, fatal, none | Minimum terminal severity (default: info) |
| –verbose | boolean | Show debug events and full retained diagnostics |
| –no-color | boolean | Disable terminal colors |
Examples
relkit dev — Run the app and its selected development features
relkit inspector
Run the project-local development inspector UI
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –port | integer | Inspector UI port (default: 3210) |
| –hostname | string | Inspector UI bind host (default: 127.0.0.1) |
Examples
relkit inspector — Run the project-local development inspector UI
relkit check
Compile descriptors, infer eligible IDs, and validate the application
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
Examples
relkit check — Compile descriptors, infer eligible IDs, and validate the application
relkit build
Build the checked graph, manifest, OpenAPI, and client
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
Examples
relkit build — Build the checked graph, manifest, OpenAPI, and client
relkit start
Start a built application
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –port | integer | Application port |
Examples
relkit start — Start a built application
relkit graph <command>
Inspect deterministic application graphs
Examples
relkit graph — Inspect deterministic application graphs
relkit graph print [graph]
Print a canonical graph with services and resolved source IDs
| Argument | Value | Description |
|---|---|---|
| graph | optional | Graph JSON path |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
Examples
relkit graph print — Print a canonical graph with services and resolved source IDs
relkit graph check [graph]
Validate a graph and optional hash
| Argument | Value | Description |
|---|---|---|
| graph | optional | Graph JSON path |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –hash | string | Expected sha256 graph hash |
Examples
relkit graph check — Validate a graph and optional hash
relkit graph diff <before> <after>
Compare graph compatibility, including inferred identity moves
| Argument | Value | Description |
|---|---|---|
| before | required | Previous graph path |
| after | required | Next graph path |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
Examples
relkit graph diff — Compare graph compatibility, including inferred identity moves
relkit env <command>
Inspect value-free environment contracts
Examples
relkit env — Inspect value-free environment contracts
relkit env check
Validate environment values
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
Examples
relkit env check — Validate environment values
relkit env list
List environment value status
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
Examples
relkit env list — List environment value status
relkit env explain <name>
Explain one environment variable
| Argument | Value | Description |
|---|---|---|
| name | required | Environment variable name |
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
Examples
relkit env explain — Explain one environment variable
relkit env example
Render or write a safe .env example
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –path / –file | string | Output path |
| –write | boolean | Write the rendered example |
Examples
relkit env example — Render or write a safe .env example
relkit local <command>
Manage project-scoped local services
Examples
relkit local — Manage project-scoped local services
relkit local up
Start all declared local services
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Limit to one service binding |
| –detach | boolean | Keep services running after exit |
Examples
relkit local up — Start all declared local services
relkit local status
Show local service and lease status
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Limit to one service binding |
Examples
relkit local status — Show local service and lease status
relkit local stop
Stop project local containers and preserve volumes
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Limit to one service binding |
Examples
relkit local stop — Stop project local containers and preserve volumes
relkit local reset
Remove project local containers, volumes, and state
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Limit to one service binding |
| –yes | boolean | Confirm reset without prompting |
| –dry-run | boolean | Show owned resources without removing them |
Examples
relkit local reset — Remove project local containers, volumes, and state
relkit jobs <command>
Inspect and operate task-backed jobs
Examples
relkit jobs — Inspect and operate task-backed jobs
relkit jobs list
List compiled job definitions
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
Examples
relkit jobs list — List compiled job definitions
relkit jobs runs <command>
Inspect accepted job runs
Examples
relkit jobs runs — Inspect accepted job runs
relkit jobs runs list
List runs with native filters
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –job | string | Job name or ID |
| –task-id | string | Task ID |
| –status | accepted, running, sleeping, retrying, completed, failed, cancelled, timed-out | Run status |
| –from | string | Lower time bound |
| –to | string | Upper time bound |
| –tag | string | Run tag; repeatable |
| –tag-match | all, any | Tag matching mode |
| –limit | integer | Rows (1-100) |
| –cursor | string | Opaque page cursor |
Examples
relkit jobs runs list — List runs with native filters
relkit jobs runs get
Read one run
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –run-id | string | Opaque run locator |
Examples
relkit jobs runs get — Read one run
relkit jobs runs watch
Watch one run as newline-delimited frames
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –run-id | string | Opaque run locator |
| –after | string | Resume cursor |
Examples
relkit jobs runs watch — Watch one run as newline-delimited frames
relkit jobs trigger
Submit validated task input
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –job | string | Job name or ID |
| –input-file | string | JSON input file |
| –idempotency-key | string | External idempotency key |
| –operation-id | string | Stable operation ID |
| –delay | string | Readable delay |
| –at | string | RFC3339 scheduled time |
Examples
relkit jobs trigger — Submit validated task input
relkit jobs cancel
Cancel one run
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –run-id | string | Opaque run locator |
| –operation-id | string | Required control operation ID |
| –reason | string | Cancellation reason |
Examples
relkit jobs cancel — Cancel one run
relkit jobs retry
Retry one terminal run
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –run-id | string | Opaque run locator |
| –operation-id | string | Required control operation ID |
Examples
relkit jobs retry — Retry one terminal run
relkit jobs capabilities
Show provider capability reports
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
Examples
relkit jobs capabilities — Show provider capability reports
relkit jobs schedules <command>
Administer native schedules
Examples
relkit jobs schedules — Administer native schedules
relkit jobs schedules list
List schedules
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –job | string | Job name or ID |
| –limit | integer | Rows (1-100) |
| –cursor | string | Opaque page cursor |
Examples
relkit jobs schedules list — List schedules
relkit jobs schedules get
Read one schedule
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –schedule-id | string | Schedule ID |
Examples
relkit jobs schedules get — Read one schedule
relkit jobs schedules upsert
Create or update a schedule
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –schedule-id | string | Schedule ID |
| –definition-file | string | JSON definition file |
| –operation-id | string | Stable operation ID |
Examples
relkit jobs schedules upsert — Create or update a schedule
relkit jobs schedules pause
Pause a schedule
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –schedule-id | string | Schedule ID |
| –operation-id | string | Stable operation ID |
Examples
relkit jobs schedules pause — Pause a schedule
relkit jobs schedules resume
Resume a schedule
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –schedule-id | string | Schedule ID |
| –operation-id | string | Stable operation ID |
Examples
relkit jobs schedules resume — Resume a schedule
relkit jobs schedules delete
Delete a schedule
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –environment / –env | string | Provider environment configuration |
| –service | string | Jobs service profile |
| –schedule-id | string | Schedule ID |
| –operation-id | string | Stable operation ID |
Examples
relkit jobs schedules delete — Delete a schedule
relkit doctor
Check local prerequisites and ports
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –port | integer | Application port |
| –inspector-port | integer | Retired; configure inspector.connection.port for the application bridge |
| –no-ports | boolean | Skip port availability checks |
| –pulumi | boolean | Require Pulumi |
| –no-pulumi | boolean | Skip Pulumi requirements |
Examples
relkit doctor — Check local prerequisites and ports
relkit deploy <command>
Manage Pulumi deployments
Examples
relkit deploy — Manage Pulumi deployments
relkit deploy init
Init the Pulumi stack
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –stack | string | Pulumi stack name (default: development) |
| –backend | string | cloud, local, or object-storage URL |
| –config | key=value | Set a non-secret Pulumi value; repeatable |
| –config-secret | key=value | Set a secret Pulumi value; repeatable |
| –non-interactive / –yes | boolean | Approve protected operations |
Examples
relkit deploy init — Init the Pulumi stack
relkit deploy preview
Preview the Pulumi stack
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –stack | string | Pulumi stack name (default: development) |
| –backend | string | cloud, local, or object-storage URL |
| –config | key=value | Set a non-secret Pulumi value; repeatable |
| –config-secret | key=value | Set a secret Pulumi value; repeatable |
| –non-interactive / –yes | boolean | Approve protected operations |
Examples
relkit deploy preview — Preview the Pulumi stack
relkit deploy up
Up the Pulumi stack
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –stack | string | Pulumi stack name (default: development) |
| –backend | string | cloud, local, or object-storage URL |
| –config | key=value | Set a non-secret Pulumi value; repeatable |
| –config-secret | key=value | Set a secret Pulumi value; repeatable |
| –non-interactive / –yes | boolean | Approve protected operations |
Examples
relkit deploy up — Up the Pulumi stack
relkit deploy refresh
Refresh the Pulumi stack
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –stack | string | Pulumi stack name (default: development) |
| –backend | string | cloud, local, or object-storage URL |
| –config | key=value | Set a non-secret Pulumi value; repeatable |
| –config-secret | key=value | Set a secret Pulumi value; repeatable |
| –non-interactive / –yes | boolean | Approve protected operations |
Examples
relkit deploy refresh — Refresh the Pulumi stack
relkit deploy outputs
Outputs the Pulumi stack
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –stack | string | Pulumi stack name (default: development) |
| –backend | string | cloud, local, or object-storage URL |
| –config | key=value | Set a non-secret Pulumi value; repeatable |
| –config-secret | key=value | Set a secret Pulumi value; repeatable |
| –non-interactive / –yes | boolean | Approve protected operations |
Examples
relkit deploy outputs — Outputs the Pulumi stack
relkit deploy destroy
Destroy the Pulumi stack
| Option | Value | Description |
|---|---|---|
| –project-root | string | Application directory (defaults to cwd) |
| –stack | string | Pulumi stack name (default: development) |
| –backend | string | cloud, local, or object-storage URL |
| –config | key=value | Set a non-secret Pulumi value; repeatable |
| –config-secret | key=value | Set a secret Pulumi value; repeatable |
| –non-interactive / –yes | boolean | Approve protected operations |
Examples
relkit deploy destroy — Destroy the Pulumi stack
relkit client <command>
Generate a client from a running application
Examples
relkit client — Generate a client from a running application
relkit client pull <baseUrl> --out <directory>
Pull a versioned client contract
| Argument | Value | Description |
|---|---|---|
| baseUrl | required | Running RELKIT application URL |
| Option | Value | Description |
|---|---|---|
| –out | string | Output directory |
Examples
relkit client pull — Pull a versioned client contract
relkit client check <baseUrl> --out <directory>
Check a pulled client for contract drift
| Argument | Value | Description |
|---|---|---|
| baseUrl | required | Running RELKIT application URL |
| Option | Value | Description |
|---|---|---|
| –out | string | Output directory |
Examples
relkit client check — Check a pulled client for contract drift