caseworkctl dev command reference
Start, stop and inspect a retained standalone local session.
Contract status
Section titled “Contract status”This page is generated from the public Clap command tree for Registry Stack source version 0.46.0 and catalog SHA-256 d43b1bf418e0b00fac52311fa3a106fa124512dbc88cf511475713af2d73aa47. Hidden implementation commands are omitted.
caseworkctl dev [OPTIONS] [PROJECT] caseworkctl dev <COMMAND>Commands
Section titled “Commands”| Command | Description |
|---|---|
start | Start or reuse the project’s retained local database and services |
stop | Stop only this project’s supervised services, preserving its database |
events | Print the bounded retained runtime journal |
token | Write a fresh bearer header for a registered local teaching or service client |
grant | Exchange an existing Casework approval using an explicit configured issuer connection |
identity | Show a standalone issuer subject before authoring local directory or task templates |
Arguments
Section titled “Arguments”| Argument | Always required | Default | Values | Environment | Description |
|---|---|---|---|---|---|
[PROJECT] | No | . | n/a | n/a | Existing authored Casework project directory |
Options
Section titled “Options”| Option | Always required | Default | Values | Environment | Description |
|---|---|---|---|---|---|
--clients-file <FILE> | No | n/a | n/a | n/a | Local clients and their directory teams (default on first start: dev-clients.yaml in the project; retained for restarts) |
--casework-port <CASEWORK_PORT> | No | n/a | n/a | CASEWORKCTL_DEV_CASEWORK_PORT | Casework loopback port on first start (prefers 8092 when available; retained for restarts) |
--issuer-port <ISSUER_PORT> | No | n/a | n/a | CASEWORKCTL_DEV_ISSUER_PORT | Local issuer loopback port on first start (prefers 8093 when available; retained for restarts) |
--issuer-project <PROJECT> | No | n/a | n/a | n/a | Ready Base Registry Engine (BReg) dev project that owns the shared issuer registration |
--database-port <DATABASE_PORT> | No | n/a | n/a | CASEWORKCTL_DEV_DATABASE_PORT | PostgreSQL loopback port on first start (prefers 15433 when available; retained for restarts) |
--format <FORMAT> | No | human | human, json | n/a | Write human diagnostics and reports, or one typed JSON report |
-h, --help | No | n/a | n/a | n/a | Print help |
Generation contract
Section titled “Generation contract”After changing a public command, argument, option, default, environment binding, or help description, run cargo run --locked -p registry-cli-docs -- --write, commit crates/registry-cli-docs/catalog.json, then run npm run generate from docs/site.