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

# evidencectl dev command reference

> Generated syntax and options for evidencectl dev.

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

Run the private local issuer and Evidence Gateway pair.

## Contract status

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

## Usage

```text
evidencectl dev [OPTIONS]
       evidencectl dev [OPTIONS] <COMMAND>
```

## Commands

| Command | Description |
| --- | --- |
| [`start`](./start/) | Start or restart the retained local issuer and Evidence pair |
| [`stop`](./stop/) | Stop the active local issuer and Evidence Gateway pair |
| [`clean`](./clean/) | Remove one completed stopped local generation |
| [`token`](./token/) | Acquire a fresh local service token and report its private header-file path |
| [`grant`](./grant/) | Exchange an existing Casework approval using an explicit configured issuer connection |

## Options

| Option | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `--detach` | No | n/a | n/a | n/a | Return after the local issuer and Evidence Gateway are ready on loopback |
| `--evidence-port <EVIDENCE_PORT>` | No | n/a | n/a | n/a | Loopback port for the local Evidence Gateway service |
| `--issuer-port <ISSUER_PORT>` | No | n/a | n/a | n/a | Loopback port for the local issuer service |
| `--issuer-project <PROJECT>` | No | n/a | n/a | n/a | Ready Base Registry Engine (BReg) dev project that owns the shared issuer and Evidence client registrations |
| `--resource <URI>` | No | n/a | n/a | n/a | Exact inbound OAuth resource for this retained Evidence session. Defaults to the local gateway resource on first start |
| `--target <TARGET>` | No | n/a | n/a | n/a | Reuse a local target's source connections and outbound TLS in the generated local caller rehearsal. Target service authentication is not replayed |
| `--format <output_format>` | No | `human` | `human`, `json`, `junit` | n/a | Select human-readable or machine-readable output. `junit` is accepted only by fixture runs (`test` and `fixtures run`) |
| `-h, --help` | 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.