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

# evidencectl target new command reference

> Generated syntax and options for evidencectl target new.

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

Create target files from explicit settings or a project-local baseline.

## Contract status

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

## Usage

```text
evidencectl target new [OPTIONS] <DIRECTORY>
```

## Constraints

| Condition | Requirement |
| --- | --- |
| `--project <PROJECT>` is present | `--local` is required. |

## Arguments

| Argument | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `<DIRECTORY>` | Yes | n/a | n/a | n/a | New target directory to create |

## Options

| Option | Always required | Default | Values | Environment | Description |
| --- | --- | --- | --- | --- | --- |
| `--settings <SETTINGS>` | No | n/a | n/a | n/a | Closed settings document with native governance, runtime, and public keys. This command checks target-file shape, logical secret references, and public-key identity. Project-specific bundle and runtime semantics are checked by `target explain`, `fixtures run --target`, `build --target`, and `doctor`. |
| `--project <PROJECT>` | No | n/a | n/a | n/a | Evidence project directory; defaults to the current directory with --local. This command needs an editable project with local signing keys when using --local. Its paths fill only omitted local filesystem settings. |
| `--local` | No | n/a | n/a | n/a | Use project-local development paths; requires local assurance governance |
| `--signing-public-key <SIGNING_PUBLIC_KEY>` | No | n/a | n/a | n/a | Public signing JWK whose RFC 7638 thumbprint names activePublicJwkFile |
| `--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 (see a summary with '-h') |

## Generation contract

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