Registry stack documentation: machine-readable Markdown.
Index of all pages: https://docs.registrystack.org/llms.txt
Full corpus: https://docs.registrystack.org/llms-full.txt

# caseworkctl dev command reference

> Generated syntax and options for caseworkctl dev.

{/* Generated from Clap command definitions by scripts/generate-cli-reference.mjs. Run npm run generate. */}

Start, stop and inspect this project's retained local Casework runtime.

## Contract status

This page is generated from the public Clap command tree for Registry Stack source version `0.34.0` and catalog SHA-256 `521175a69262e60df96745886392348e5bb8d82e63cdd24bdf4baa80d46e5ff4`. Hidden implementation commands are omitted.

## Usage

```text
caseworkctl dev [OPTIONS] [PROJECT]
       caseworkctl dev <COMMAND>
```

## Commands

| Command | Description |
| --- | --- |
| [`start`](./start/) | Start or reuse the project's retained local database and services |
| [`stop`](./stop/) | Stop only this project's supervised services, preserving its database |
| [`events`](./events/) | Print the bounded retained runtime journal |
| [`token`](./token/) | Write a fresh bearer header for a registered local teaching or service client |
| [`grant`](./grant/) | Exchange an existing Casework approval using an explicit configured issuer connection |
| [`identity`](./identity/) | Show a stable native subject before authoring local directory or task templates |

## Arguments

| Argument | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `[PROJECT]` | No | `.` | n/a | n/a | Existing authored Casework project directory |

## Options

| Option | Always required | Repeatable | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- | --- |
| `--clients-file <FILE>` | No | 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 | No | n/a | n/a | `CASEWORKCTL_DEV_CASEWORK_PORT` | Casework loopback port on first start (default 8092; retained for restarts) |
| `--issuer-port <ISSUER_PORT>` | No | No | n/a | n/a | `CASEWORKCTL_DEV_ISSUER_PORT` | Local issuer loopback port on first start (default 8093; retained for restarts) |
| `--issuer-project <PROJECT>` | No | 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 | No | n/a | n/a | `CASEWORKCTL_DEV_DATABASE_PORT` | PostgreSQL loopback port on first start (default 55433; retained for restarts) |
| `--source-project <[ID=]PATH>` | No | Yes | n/a | n/a | n/a | Running Base Registry Engine (BReg) dev project serving a declared source. This compatibility bridge is available only without explicit integrations or task templates |
| `--format <FORMAT>` | No | No | `human` | `human`, `json` | n/a | Emit the selected command's report in this format |
| `-h, --help` | No | No | n/a | n/a | n/a | Print help |

## Generation contract

Run `npm run generate` from `docs/site` after changing a public command, argument, option, default, environment binding, or help description.