# `init` command

Create a new project manifest

## Syntax

console

    $ docinsight init --help
    Create a new project manifest

    Usage: docinsight init [OPTIONS] [PATH]

    Options:
      -h, --help
              Print help

    Project Options:
          --name <NAME>
              Project identifier (ASCII, e.g. my-library, my_library, or MyLibrary)

          --title <TITLE>
              Project title

          --reference-root <PATH>
              Reference root for authored root-relative paths (relative to the project directory)

      -t, --template <NAME>
              Project template to use

              [default: empty]
              [possible values: empty, markdown, delphi]

          --from-legacy <FILE>
              Import from a legacy .diproj manifest

      [PATH]
              Project directory to initialize

              [default: .]

    Init Options:
          --force
              Allow overwriting an existing manifest

          --dry-run
              Report changes without writing files

    Output Options:
      -q, --quiet
              Suppress all messages except for warnings and errors

      -v, --verbose...
              Increase output detail (-v for verbose, -vv for full operational details)

    Terminal Options:
          --color <WHEN>
              When to use terminal colors

              [possible values: auto, always, never]

          --no-color
              Disable terminal colors

          --progress <WHEN>
              When to display progress indicators

              [possible values: auto, always, never]

          --no-progress
              Disable progress indicators

          --hyperlinks <WHEN>
              When to emit terminal hyperlinks

              [possible values: auto, always, never]

          --no-hyperlinks
              Disable terminal hyperlinks

    Interaction Options:
          --no-input
              Never prompt for user input

    Logging Options:
          --log-file <PATH>
              Write diagnostic logs to a file

              [env: DOCINSIGHT_LOG_FILE=]

          --log-level <LEVEL>
              Set the minimum diagnostic log level

              [env: DOCINSIGHT_LOG_LEVEL=]
              [possible values: error, warn, info, debug, trace]