claudewheel Documentation https://smmh.dev/claudewheel/ 2026-09-16T00:00:00Z A TUI Claude Code Launcher that lets you have more than one profile, manage sessions lifecycle, pick the exact CC version, model to use (even older unlisted ones), pick which GitHub account to use, etc. claudewheel.__main__ https://smmh.dev/claudewheel/claudewheel-__main__/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.app https://smmh.dev/claudewheel/claudewheel-app/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.appdata https://smmh.dev/claudewheel/claudewheel-appdata/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.archiver https://smmh.dev/claudewheel/claudewheel-archiver/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.auth https://smmh.dev/claudewheel/claudewheel-auth/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.binaries https://smmh.dev/claudewheel/claudewheel-binaries/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.cli https://smmh.dev/claudewheel/claudewheel-cli/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.clients https://smmh.dev/claudewheel/claudewheel-clients/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.config https://smmh.dev/claudewheel/claudewheel-config/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.constants https://smmh.dev/claudewheel/claudewheel-constants/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.defaults https://smmh.dev/claudewheel/claudewheel-defaults/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.deletion_checklist https://smmh.dev/claudewheel/claudewheel-deletion_checklist/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.discovery https://smmh.dev/claudewheel/claudewheel-discovery/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.effects https://smmh.dev/claudewheel/claudewheel-effects/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.fuzzy https://smmh.dev/claudewheel/claudewheel-fuzzy/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.guardrail https://smmh.dev/claudewheel/claudewheel-guardrail/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.health https://smmh.dev/claudewheel/claudewheel-health/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.hook_scripts https://smmh.dev/claudewheel/claudewheel-hook_scripts/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.hooks https://smmh.dev/claudewheel/claudewheel-hooks/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.import_ https://smmh.dev/claudewheel/claudewheel-import_/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.install https://smmh.dev/claudewheel/claudewheel-install/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.launch https://smmh.dev/claudewheel/claudewheel-launch/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.lifecycle https://smmh.dev/claudewheel/claudewheel-lifecycle/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.migrate https://smmh.dev/claudewheel/claudewheel-migrate/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.mv https://smmh.dev/claudewheel/claudewheel-mv/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.patch_profiles https://smmh.dev/claudewheel/claudewheel-patch_profiles/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.permission https://smmh.dev/claudewheel/claudewheel-permission/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.plugins https://smmh.dev/claudewheel/claudewheel-plugins/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.preflight https://smmh.dev/claudewheel/claudewheel-preflight/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.processes https://smmh.dev/claudewheel/claudewheel-processes/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile https://smmh.dev/claudewheel/claudewheel-profile/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile_data https://smmh.dev/claudewheel/claudewheel-profile_data/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile_info https://smmh.dev/claudewheel/claudewheel-profile_info/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile_ops https://smmh.dev/claudewheel/claudewheel-profile_ops/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile_store https://smmh.dev/claudewheel/claudewheel-profile_store/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.project_hooks https://smmh.dev/claudewheel/claudewheel-project_hooks/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.pty_runner https://smmh.dev/claudewheel/claudewheel-pty_runner/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.reconcile https://smmh.dev/claudewheel/claudewheel-reconcile/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.renderer https://smmh.dev/claudewheel/claudewheel-renderer/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.scratchpad https://smmh.dev/claudewheel/claudewheel-scratchpad/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.segment https://smmh.dev/claudewheel/claudewheel-segment/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.session https://smmh.dev/claudewheel/claudewheel-session/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.session_list https://smmh.dev/claudewheel/claudewheel-session_list/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.session_registry https://smmh.dev/claudewheel/claudewheel-session_registry/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.session_rows https://smmh.dev/claudewheel/claudewheel-session_rows/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.sessions_overview https://smmh.dev/claudewheel/claudewheel-sessions_overview/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.sessions_table https://smmh.dev/claudewheel/claudewheel-sessions_table/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.shared_store https://smmh.dev/claudewheel/claudewheel-shared_store/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.state https://smmh.dev/claudewheel/claudewheel-state/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.stats https://smmh.dev/claudewheel/claudewheel-stats/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.strictspec_gen.lifecycle_event_validator https://smmh.dev/claudewheel/claudewheel-strictspec_gen-lifecycle_event_validator/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.strictspec_gen https://smmh.dev/claudewheel/claudewheel-strictspec_gen/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.terminal https://smmh.dev/claudewheel/claudewheel-terminal/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.theme https://smmh.dev/claudewheel/claudewheel-theme/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.tokens https://smmh.dev/claudewheel/claudewheel-tokens/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.ui https://smmh.dev/claudewheel/claudewheel-ui/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.vertical_viewport https://smmh.dev/claudewheel/claudewheel-vertical_viewport/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.wizard https://smmh.dev/claudewheel/claudewheel-wizard/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.workspace https://smmh.dev/claudewheel/claudewheel-workspace/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel https://smmh.dev/claudewheel/claudewheel/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> c config https://smmh.dev/claudewheel/cli-config/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c deploy-hooks https://smmh.dev/claudewheel/cli-deploy-hooks/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c health https://smmh.dev/claudewheel/cli-health/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c import https://smmh.dev/claudewheel/cli-import/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c CLI Reference https://smmh.dev/claudewheel/cli-index/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c install https://smmh.dev/claudewheel/cli-install/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c launch https://smmh.dev/claudewheel/cli-launch/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c migrate https://smmh.dev/claudewheel/cli-migrate/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c mv https://smmh.dev/claudewheel/cli-mv/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c patch-profiles https://smmh.dev/claudewheel/cli-patch-profiles/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c permission https://smmh.dev/claudewheel/cli-permission/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c profile https://smmh.dev/claudewheel/cli-profile/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c purge-plugins https://smmh.dev/claudewheel/cli-purge-plugins/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c reconcile-permissions https://smmh.dev/claudewheel/cli-reconcile-permissions/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c reset-options https://smmh.dev/claudewheel/cli-reset-options/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c show https://smmh.dev/claudewheel/cli-show/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c stats https://smmh.dev/claudewheel/cli-stats/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c uninstall https://smmh.dev/claudewheel/cli-uninstall/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c versions https://smmh.dev/claudewheel/cli-versions/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> Configuration https://smmh.dev/claudewheel/config/ 2026-09-16T00:00:00Z claudewheel's configuration lives in four JSON files under `~/.claudewheel/`. On first run, each file is created from built-in defaults. On subsequent runs, a migration system adds new keys and applies one-time schema fixes without overwriting existing user values. API Reference https://smmh.dev/claudewheel/gen-index/ 2026-09-16T00:00:00Z <!-- generated by selfdoc gen, do not edit --> Getting Started https://smmh.dev/claudewheel/getting-started/ 2026-09-16T00:00:00Z This tutorial walks through installing claudewheel, creating a profile, navigating the segment bar, and launching your first Claude Code session. Guardrails https://smmh.dev/claudewheel/guardrails/ 2026-09-16T00:00:00Z claudewheel ships a canonical set of command guardrails that every profile inherits. The guardrails discourage or block destructive shell commands (bulk `git add`, `rm`, history rewrites, branch deletion) and steer agents toward safe alternatives such as `safegit` and `saferm`. The rules live in one place and drive both the deployed hook scripts and each profile's permission arrays. Health Checks and Preflight https://smmh.dev/claudewheel/health/ 2026-09-16T00:00:00Z claudewheel runs two categories of diagnostics: **health checks** (on-demand inspection of the entire profile fleet) and **preflight steps** (a fixed sequence of gates that run before every session launch). Health checks are read-only and report problems. Preflight steps can block a launch or self-heal configuration drift. claudewheel https://smmh.dev/claudewheel/ 2026-09-16T00:00:00Z A TUI Claude Code Launcher that lets you have more than one profile, manage sessions lifecycle, pick the exact CC version, model to use (even older unlisted ones), pick which GitHub account to use, etc. Profiles https://smmh.dev/claudewheel/profiles/ 2026-09-16T00:00:00Z A profile is an isolated Claude Code configuration directory. Each profile carries its own `settings.json` (permissions, hooks, behavior flags) and its own authentication credentials, so multiple Claude Code sessions can run simultaneously under different identities, permission sets, and guardrail configurations without interfering with each other. Theming https://smmh.dev/claudewheel/theming/ 2026-09-16T00:00:00Z claudewheel uses a JSON-based theming system that converts hex colors into 24-bit ANSI escape sequences at startup. Theme files live in `~/.claudewheel/themes/` and are loaded by the config store before the TUI renders.