Updated Edit
On this page
Complete CLI reference for claudewheel: profile management, health checks, permission reconciliation, session import, hook deployment, and every command.
#c CLI Reference
claudewheel - TUI launcher for Claude Code with profile, model, and directory selection
Version: 0.20.0
#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 -- sync existing profiles and shared-settings.json to canonical hook and disallowedTools defaults
- reconcile-permissions -- reconcile profile and shared-settings permissions (deny/ask/allow) to the canonical guardrail model; requires exactly one of --dry-run or --apply
- 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