claudewheel v0.15.1 /claudewheel.wizard
Updated Edit
On this page

Form-style TUI wizard for creating new Claude Code profiles.

#claudewheel.wizard

#claudewheel.wizard

Interactive form wizard for creating and configuring new profiles.

#WizardField

Defines a single input field in the profile creation wizard.

#WizardResult

Collected values from a completed profile wizard run.

#_get_field

python
def _get_field(fields: list[WizardField], label: str) -> WizardField

Look up a wizard field by its label.

#_validate_name

python
def _validate_name(name: str, existing_profiles: list[str]) -> str | None

Return error message, or None if valid.

#_build_fields

python
def _build_fields(existing_profiles: list[str]) -> list[WizardField]

Build the ordered list of wizard fields.

#_is_advanced_expanded

python
def _is_advanced_expanded(fields: list[WizardField]) -> bool

Return True when the Advanced toggle is set to show checkboxes.

#_visible_fields

python
def _visible_fields(fields: list[WizardField]) -> list[WizardField]

Return fields that should be rendered based on current Advanced toggle.

#_focusable_indices

python
def _focusable_indices(fields: list[WizardField]) -> list[int]

Return indices into fields that are visible and interactive.

#_build_result

python
def _build_result(fields: list[WizardField]) -> WizardResult

Construct a WizardResult from current field values.

#_hints_for_field

python
def _hints_for_field(f: WizardField) -> str

Return context-sensitive keyboard hint text for the given field.

#_render

python
def _render(term: Terminal, fields: list[WizardField], focus: int, error: str='') -> None

Render the full wizard form centered in the terminal.

#_cancelled_result

python
def _cancelled_result() -> WizardResult

Return a cancelled WizardResult with zero-value fields.

#run_profile_wizard

python
def run_profile_wizard(existing_profiles: list[str]) -> WizardResult

Run the form TUI and return the user's choices.

#_load_shared_settings

python
def _load_shared_settings() -> dict

Load shared-settings.json, falling back to canonical defaults if missing.

#create_profile

python
def create_profile(result: WizardResult, cfg: ConfigManager) -> None

Execute the profile creation based on wizard results.