Commands

Global flags

These flags are available on every invocation:

copydeck [OPTIONS] COMMAND [ARGS]...

Flag	Description
-c, --config PATH	Path to config file (overrides COPYDECK_CONFIG env var and default)
-v, --verbose	Increase verbosity. Use once for INFO, twice (-vv) for DEBUG
--version	Print version and exit
--help	Show help

---

config

Manage the CopyDeck configuration file and sources.

config init

Initialise a new config file at the resolved path. Prompts for confirmation if the file already exists.

copydeck config init

config show

Display the current configuration. Shows all sources, or a single named source.

copydeck config show
copydeck config show --name my-gitlab

Option	Description
--name NAME	Show only the named source

config new

Add a new source interactively. Prompts for name, type, and all relevant fields.

copydeck config new
copydeck config new --name my-gitlab

Option	Description
--name NAME	Pre-fill the source name (prompted if omitted)

Note

Tokens are never prompted — supply them via environment variables. See Configuration — Environment variables.

config set

Set a field on an existing source. Fully interactive if KEY and VALUE are omitted.

copydeck config set --name my-gitlab
copydeck config set --name my-gitlab path new-group/templates

Option / Argument	Description
--name NAME	Source to edit (required)
KEY (positional, optional)	Field name to set
VALUE (positional, optional)	New value

Caution

name and type cannot be changed with this command.

config delete

Remove a source from the config. Prompts for confirmation unless --auto-approve is set.

copydeck config delete --name my-gitlab
copydeck config delete --name my-gitlab --auto-approve

Option	Description
--name NAME	Source to delete (required)
--auto-approve	Skip the confirmation prompt

config edit

Open the config file in $EDITOR (falls back to vim).

copydeck config edit

---

template

Discover and apply Copier templates from configured sources.

template list

List available Copier templates across all enabled sources, or a single named source. Output is rendered as a table with columns: ID, Name, Description, URL.

copydeck template list
copydeck template list --source my-gitlab
copydeck template list -s my-gitlab

Option	Description
-s, --source NAME	Filter to a single named source

Note

Sources that return a 404 are skipped with a warning rather than aborting.

template new

Apply a template to a directory using Copier.

copydeck template new SOURCE/TEMPLATE
copydeck template new SOURCE/TEMPLATE ./my-project

Argument	Default	Description
SOURCE/TEMPLATE	required	Source name and template name separated by / (e.g. my-gitlab/my-template)
OUTPUT_DIRECTORY	. (current directory)	Destination directory for generated files

---

info

Caution

Not yet implemented. This command is a stub and will raise an error.

Display information about a specific template.

copydeck info TEMPLATE_NAME