claudewheel v0.20.1 /c CLI Reference
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