charm init - Charm Docs

Scaffold a new Charm agent project.

Usage

charm init <name> [--template <template>] [--create <file>] [--interactive]

Create a minimal Python agent:

charm init my-agent --template python

Start an interactive prompt for template selection:

charm init my-agent --interactive

Create a single file from a template:

charm init . --create charm.yaml

Option	Description
`name`	Agent directory path. Use `.` for the current directory.
`--template`	Template to use. Defaults to `python`. Valid values are fetched dynamically from the community templates registry (e.g., `python`, `openclaw`, `slack-bot`).
`--create`	Create a single file instead of a full project.
`--interactive`, `-i`	Launch guided template selection.

Most templates produce:

my-agent/
├── charm.yaml
├── requirements.txt or pyproject.toml
└── src/
    └── main.py

After scaffolding, run:

cd my-agent
charm validate .
charm run . --input "Hello"