Skip to main content

init

Generate a new ChimeraX bundle project.

Usage

echi init [OPTIONS] [PATH]

Arguments

ArgumentDescription
PATHProject name or path. Creates the directory if it doesn't exist. If omitted, initializes in the current directory.

Options

OptionDescription
-n, --name <NAME>Override the project name (defaults to directory name)
-t, --type <TYPE>Bundle type (default: command). See Bundle Types
--bundle-name <NAME>Bundle name (e.g., ChimeraX-MyTool)
--package <NAME>Python package name (e.g., chimerax.mytool)
-f, --forceOverwrite existing files

Examples

# Create in new directory
echi init my-tool

# Create in current directory with custom name
echi init --name my-tool .

# Create a Qt GUI tool
echi init --type tool my-gui-tool

# Override bundle/package names
echi init --bundle-name ChimeraX-MyTool --package chimerax.mytool .

Name Derivation

When you run echi init my-tool, the following names are derived automatically:

FieldValue
Bundle nameChimeraX-MyTool
Package namechimerax.mytool
Command namemy_tool
Tool nameMy Tool (for GUI tools)

You can override these with --bundle-name and --package.