Paths

🚀CLI Paths

Active

Detect supported version metadata or select an explicit version target.

Command[tool.custy.cli.paths]

📦Category

CLI Configuration

🚀Quick Command

version_file = "auto"

---

version metadataautomatic detectionproject root

---

📋

Properties

1

📄

Generated Default

auto

✅

Status

Active

💻

CLI Override

Supported

Properties

📋Properties

Property	Type	Description	Default	Required
version_file	Path string or auto	Use auto to detect an existing Python __version__.py, a static project.version in pyproject.toml, or a string version in package.json. An explicit path must exist and be a file.	auto	No

Automatic detection (recommended)

toml

[tool.custy.cli.paths]
version_file = "auto"

src layout

toml

[tool.custy.cli.paths]
version_file = "src/my_package/__version__.py"

ℹ️Projects without version metadata are valid

If automatic detection finds no supported version target, Custy can still start, initialize configuration, and use Git-tag-only versioning. It does not invent a Python file in Node.js or generic projects. Configure an explicit target only when the project owns a different version file.

⚠️This is not project_source

project.project_source identifies the main source directory. version_file identifies one metadata file inside the project. Either value can remain auto, and each explicit override is validated independently.

Continue

🚀Related Commands

Commands commonly used together with this command.

Versioning

Choose how values in the version file are interpreted.

Project

Configure the main source directory.

Version Configuration

Review command-specific version resolution.