ct run env-description-generate
Generate a fresh docs/description.md for one or more environments.
Usage
ct run env-description-generate [OPTIONS]
Options
| Option | Description |
|---|---|
-e, --env TEXT | Environment(s) to generate a description for. Required. [required] |
-n, --name TEXT | Name prefix for the output run directory. |
-c, --max-concurrent INTEGER RANGE | Maximum concurrent API calls (default: 2). [x>=1] |
-m, --model TEXT | Anthropic model ID to use, e.g. claude-opus-4-7 or claude-sonnet-4-6. Aliases (opus, sonnet) and non-Anthropic model IDs are not supported (default: claude-opus-4-7). |
--dry-run | Write to docs/description.draft.md instead of description.md, leaving the original untouched. Useful for side-by-side review. |
--overwrite | Required to replace an existing docs/description.md. Without this flag (and without --dry-run), the command aborts up front for any env that already has a description, to protect uncommitted edits. |
--max-chars INTEGER RANGE | Hard cap on source chars sent per env (default 300,000 ≈ 75k tokens). If a codebase exceeds this, files past the cap are dropped with a truncation marker. Increase if completeness suffers; decrease to save tokens on big batches. [x>=1] |
--ignore-ext TEXT | File extension to skip in addition to the built-in skips (binary files, lock files, etc.). Repeatable, e.g. --ignore-ext .txt --ignore-ext .log. Pass with or without leading dot. |
--help | Show this message and exit. |