@rimthan/rimctl
v0.0.10
Published
Agent-friendly CLI for Rimthan OS APIs.
Readme
rimctl
rimctl is the agent-friendly command-line client for Rimthan OS APIs.
Install
npm install --global @rimthan/rimctlQuick start
rimctl login [email protected]
rimctl auth doctor
rimctl whoami
rimctl workflows validate --file workflow.yaml
rimctl profile list
rimctl --tenant tenant_123 workflows create --file workflow.yaml
rimctl --tenant tenant_123 runs start --release rel_123 --idempotency-key run-001 --input @input.json
rimctl --tenant tenant_123 runs get exec_123 --summary
rimctl --tenant tenant_123 --output ndjson runs follow exec_123Configuration
rimctl reads config from ~/.config/rimctl/config.json by default. You can also pass auth and tenant
context through flags or environment variables.
Global inputs:
--profile,--config--base-url,--api-version--tenant--tokenor--api-key--output json|text|ndjson--request-id,--correlation-id
By default rimctl targets the public API origin https://api.os.rimthan.cloud. Use --base-url,
RIMCTL_BASE_URL, or a profile override when working against local or non-prod environments.
Successful rimctl login now saves credentials into the active profile automatically. If no profile
is active yet, it writes a default profile and marks it as the CLI default, so later commands can
omit --profile. Use --save-profile <name> to name the saved profile explicitly, or --no-save
for an ephemeral one-off login.
Release workflow
The npm package is published from the monorepo build output in dist/apps/cli.
- Bump
apps/cli/package.jsonversion. - Validate the package locally:
pnpm nx build cli
cd dist/apps/cli
npm pack --dry-run- Publish through Depot by either:
- pushing the version bump commit to
devafter updatingapps/cli/package.json - or running the
Publish @rimthan/rimctlDepot workflow manually
