Env, Tools & Diagnostics

The operational command groups you reach for day to day: tenant environment variables, the tool catalog, CLI configuration, and the two health commands.

env — tenant environment variables

These commands manage the tenant environment store. Scripts read these values at runtime (see the env block); secrets never live in script source.

env set <key> <value>

dodil scriptum env set SLACK_TOKEN "xoxb-..."

env get <key>

dodil scriptum env get SLACK_TOKEN

env list

Review all configured environment entries.

dodil scriptum env list

Security note. env list output currently includes values, not keys only. Treat it as sensitive — avoid sharing it in tickets or screenshots.

env delete <key>

dodil scriptum env delete LEGACY_API_KEY

env import <file>

Bulk-import from a .env-format file (KEY=VALUE). Existing keys are overwritten; blank lines and # comments are ignored, and surrounding quotes are stripped.

dodil scriptum env import ./.env.scriptum

Per-script environment overlays are API-only — there is no CLI command for them. See API Gaps & Workarounds.

tool — the tool catalog

tool list

Inspect the tools visible to your tenant, with their version, description, and inputs (a * marks required inputs).

dodil scriptum tool list --page-size 100

The CLI supports listing only. Tool registration and per-tool lookup are API-only — see API Gaps & Workarounds.

config — CLI configuration

config init

Create a default config file at the resolved config path.

dodil scriptum config init

config view

Display the effective configuration. The token is masked.

dodil scriptum config view

config set <key> <value>

Persist a value. Valid keys: api_endpoint, token, org_id, org_name, output, debug.

dodil scriptum config set api_endpoint rpc.dev.dodil.io:443
dodil scriptum config set output json

Full config-path resolution and precedence are single-sourced in Install the CLI . Scriptum reads the scriptum.* config section with a global.* fallback, and the SCRIPTUM_* environment variables override config.

health — server status

Report server status, version, and uptime through the health RPC.

dodil scriptum health

doctor — connectivity and auth diagnostics

Run a checklist before real work: config file presence, API endpoint, token, organization, server reachability, and a lightweight auth check (a 1-item script list).

dodil scriptum doctor

Each line reports [OK], [WARN], or [FAIL], ending with a pass/warn/fail summary. Run it after configuration changes or when commands start failing with transport or auth errors.

Day-to-day playbooks

Rotate a key and smoke-test

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

Verify after a configuration change

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

See also

• Env promotion and rollback — promoting env and versions safely.
• API Gaps & Workarounds — script env overlays, tool registration, and other API-only operations.
• Auth and Access — how tenant identity is enforced.