Problem
Some template repos host multiple templates in subdirectories — e.g. raiderrobert/templates with rust-cli, godot-tag-game, claude-code-plugin. Authors currently hand-write a catalog README with install instructions for each. The diecut share feature handles a single template; this ticket extends it to emit a catalog when run at a repo root.
Proposed feature
When diecut share runs at the root of a repo with no diecut.toml directly in cwd but one or more subdirectories containing diecut.toml, emit a catalog:
# Templates
| Template | Description | Install |
|---|---|---|
| rust-cli | A command-line tool | `diecut new gh:user/templates/rust-cli` |
| godot-tag-game | A game built with Godot | `diecut new gh:user/templates/godot-tag-game` |
- Template name = subdirectory name
- Description = new optional
description field in diecut.toml (or first line of template's own README as fallback)
- Install command = what single-template
diecut share would emit for each subdirectory
Dependencies
diecut share (single-template mode) must land first — this is a mode extension of the same command.
Open questions
- Description source: new
diecut.toml field, parsed README first line, or both?
- Write target: repo root
README.md (with fence markers) or dedicated CATALOG.md?
Acceptance criteria
Problem
Some template repos host multiple templates in subdirectories — e.g.
raiderrobert/templateswithrust-cli,godot-tag-game,claude-code-plugin. Authors currently hand-write a catalog README with install instructions for each. Thediecut sharefeature handles a single template; this ticket extends it to emit a catalog when run at a repo root.Proposed feature
When
diecut shareruns at the root of a repo with nodiecut.tomldirectly in cwd but one or more subdirectories containingdiecut.toml, emit a catalog:descriptionfield indiecut.toml(or first line of template's own README as fallback)diecut sharewould emit for each subdirectoryDependencies
diecut share(single-template mode) must land first — this is a mode extension of the same command.Open questions
diecut.tomlfield, parsed README first line, or both?README.md(with fence markers) or dedicatedCATALOG.md?Acceptance criteria
diecut.tomlpresent but subdirectories containing one