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

# evidencectl dev start command reference

> Generated syntax and options for evidencectl dev start.

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

Start or restart the retained local issuer and Evidence pair.

## 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
evidencectl dev start [OPTIONS] [PROJECT]
```

## Arguments

| Argument | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `[PROJECT]` | No | `.` | n/a | n/a | Project root. Defaults to the current directory |

## Options

| Option | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `--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` | n/a | Select human-readable or machine-readable output |
| `-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.