Project
CLI

Modules

List, inspect, add, and remove template modules.

project module

Manage project template modules.

project module [command]

Available commands:

CommandSynonymsDescription
list-List available and installed modules.
show-Show details for one module.
addinstallAdd a module to the project.
remove-Remove a module from the project.

project module list

project module list [directory] [flags]

Arguments

ArgumentRequiredDefaultDescription
directoryno.Project directory.

Flags

FlagSynonymsTypeDefaultDescription
--format-stringprettyOutput format. Use tsv for filtering.
--help-hbooleanfalsePrint help.

Examples

project module list
project module list --format tsv

project module show

project module show <module> [directory] [flags]

Arguments

ArgumentRequiredDefaultDescription
moduleyesnoneModule name.
directoryno.Project directory.

Flags

FlagSynonymsTypeDefaultDescription
--format-stringprettyOutput format. Use tsv for filtering.
--help-hbooleanfalsePrint help.

Examples

project module show core.repo
project module show core.repo --format tsv

project module add

Add a module to a project.

project module add <module> [directory] [flags]

Synonym: project module install <module> [directory] [flags]

Arguments

ArgumentRequiredDefaultDescription
moduleyesnoneModule name.
directoryno.Project directory.

Flags

FlagSynonymsTypeDefaultDescription
--dry-run-booleanfalseShow the module add plan without writing changes.
--force-booleanfalseAllow module add to overwrite existing project files.
--format-stringprettyOutput format. Use tsv with --dry-run or --yes.
--yes-ybooleanfalseApply without prompting.
--help-hbooleanfalsePrint help.

Behavior

  • Prints a plan before writing.
  • Prompts before applying unless --yes is passed.
  • Fails on file conflicts unless --force is passed.
  • --dry-run never writes files.

Examples

project module add core.repo --dry-run
project module add core.repo
project module add core.repo --yes
project module add core.repo --dry-run --format tsv

project module remove

Remove a module from a project.

project module remove <module> [directory] [flags]

Arguments

ArgumentRequiredDefaultDescription
moduleyesnoneModule name.
directoryno.Project directory.

Flags

FlagSynonymsTypeDefaultDescription
--dry-run-booleanfalseShow the module remove plan without writing changes.
--format-stringprettyOutput format. Use tsv with --dry-run or --yes.
--yes-ybooleanfalseApply without prompting.
--help-hbooleanfalsePrint help.

Examples

project module remove core.repo --dry-run
project module remove core.repo --yes
project module remove core.repo --dry-run --format tsv

On this page