Updated Edit
On this page
claudewheel CLI reference: TUI launcher, profile and permission management, health checks, installs, session tools, guardrails.
#c CLI Reference
claudewheel - TUI launcher for Claude Code with profile, model, and directory selection
Version: 0.24.2
#Commands
- health -- run diagnostic health checks on profiles, tokens, and hooks, then exit
- config -- open the ~/.claudewheel/ config directory in your $EDITOR
- versions -- list all installed Claude Code versions, marking the current symlink target
- install -- download and install a specific Claude Code version
- uninstall -- delete an installed Claude Code version binary from the versions directory
- reset-options -- delete options.json so it regenerates from defaults
- show -- print a summary of current segment selections, theme, and recent directories
- migrate -- move session data files from one profile to another, optionally filtered by UUID
- stats -- report shared-store stats and clean up legacy data
- mv -- rename a project directory and migrate session data
- import -- import session data from an external Claude Code directory
- deploy-hooks -- deploy built-in hook scripts to the ~/.claudewheel/scripts/ directory
- patch-profiles -- reconcile every managed profile and shared-settings.json to EXACTLY the canonical guardrail model (hooks, disallowedTools, permissions deny/ask); prunes drift and user-added extras -- the old additive, extras-preserving behavior is gone. Deploys any missing guardrail hook scripts. The 'default' profile (~/.claude) is never touched. Preview with --dry-run; writing needs a terminal or --approve-consequential.
- reconcile-permissions -- reconcile every managed profile and shared-settings.json to EXACTLY the canonical guardrail model (hooks, disallowedTools, permissions deny/ask made exact; allow keeps only its non-conflicting entries); prunes all drift and user-added extras. The 'default' profile (~/.claude) is never touched. Pass --dry-run to preview the per-target diff without writing; writing needs a terminal to confirm at, or --approve-consequential.
- launch -- start the interactive TUI launcher to select a profile, model, and directory
#Command Groups
- profile -- create, inspect, rename, delete, and manage Claude Code profiles and their stored tokens
- permission -- add, remove, and list permission rules across Claude profiles
#Framework flags
These flags are owned by the strictcli framework, not by the app. No command may declare a flag with one of these names, and each is recognized anywhere on the command line.
| Flag | Effect |
|---|---|
--dry-run | Preview mode: no mutation runs. The framework prints a log of every effect the command would have performed. |
--approve-consequential | Skips the confirmation prompt a consequential command shows before it runs. |
--quiet | Hides informational output. Warnings, errors, structured data and the dry-run log are never suppressed. |
--verbose | Shows debug output. --quiet wins when both are passed. |
#Deprecated
delete-profile-- Renamed: use 'claudewheel profile delete' instead. new-profile-- Renamed: use 'claudewheel profile create' instead.show-profile-- Renamed: use 'claudewheel profile show' instead.