Env, Tool, Health, and Diagnostics Commands

Last validated: 2026-05-14

This page covers operational command groups used in day-to-day platform operation.

1) Tenant Environment Commands

`env set <key> <value>`

Use case:

Set or update one tenant env variable.

Example:


dodil scriptum env set OPENAI_API_KEY "sk-..."

`env get <key>`

Use case:

Verify one value before runtime changes.

Example:


dodil scriptum env get OPENAI_API_KEY

`env list`

Use case:

Review all currently configured env keys and values.

Example:


dodil scriptum env list

Security note:

API currently returns values, not keys-only. Avoid sharing this output in tickets or screenshots.

`env delete <key>`

Use case:

Remove obsolete secret/config values.

Example:


dodil scriptum env delete LEGACY_API_KEY

`env import <file>`

Use case:

Bulk import from .env format (KEY=VALUE).

Example:


dodil scriptum env import ./.env.scriptum

Import behavior:

Existing keys are overwritten.
Empty lines and comments are ignored.

2) Tool Catalog Command

`tool list`

Use case:

Inspect tools currently visible to tenant.

Flag:

--page-size

Example:


dodil scriptum tool list --page-size 100

Caveats:

CLI supports list only.
API RegisterTool and GetTool are currently unimplemented server-side.

3) Health and Readiness Checks

`health`

Use case:

Check server status/version/uptime through HealthCheck RPC.

Example:


dodil scriptum health

`doctor`

Use case:

Validate config, endpoint, token, organization, service reachability, and auth.

Example:


dodil scriptum doctor

Checks include:

config file availability
API endpoint presence
token/organization values
health RPC reachability
lightweight auth verification using ListScripts

4) Command Completion

Generate shell completion scripts:


dodil scriptum completion bash
dodil scriptum completion zsh
dodil scriptum completion fish
dodil scriptum completion powershell

5) Common Operations Playbook

Safely rotate a key


dodil scriptum env set OPENAI_API_KEY "sk-new"
dodil scriptum env get OPENAI_API_KEY
dodil scriptum draft test invoice-parser --input @./smoke.json --env

Verify platform after deployment


dodil scriptum doctor
dodil scriptum health
dodil scriptum script list --page-size 1

6) What This CLI Does Not Cover Yet

Script env overlay APIs (GetScriptEnv, UpdateScriptEnv)
Template APIs (ListTemplates, GetTemplate)
Thread resume/cancel commands
Script code retrieval (GetScriptCode)

See workaround examples in 05-api-gaps-and-grpc-http-workarounds.md.