Usage

Command Reference

init

Initializes a new project with the specified template.

vcl init <template> <name>

Available Templates

• api - FastAPI project template
• lib - Python library template
• cli - Command-line tool template

Options

• --path - Custom initialization path
• --python-version - Specify Python version
• --no-git - Skip git initialization

add

Add dependencies to your project.

vcl add [options] <packages...>

Options

• -g, --group <name> - Dependency group (dev, test, etc.)
• -e, --extras <name> - Package extras to install
• --pre - Allow pre-release versions

sync

Synchronize project dependencies and environment.

vcl sync [options]

Options

• --all-groups - Sync all dependency groups
• --all-extras - Include all package extras
• --no-cache - Skip using cached packages

run

Execute project scripts defined in pyproject.toml.

vcl run <script>

TODO & Updates Needed

• Add examples for each command option
• Document environment variables
• Add common use cases and recipes
• Include error handling and debugging tips
• Document hooks and extension points