claudewheel Documentation https://smmh.dev/claudewheel/ 2026-08-12T00:00:00Z TUI launcher for Claude Code: pick a profile, model, directory, and permissions from a segment bar, then launch. claudewheel.__main__ https://smmh.dev/claudewheel/claudewheel-__main__/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.app https://smmh.dev/claudewheel/claudewheel-app/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.appdata https://smmh.dev/claudewheel/claudewheel-appdata/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.auth https://smmh.dev/claudewheel/claudewheel-auth/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.binaries https://smmh.dev/claudewheel/claudewheel-binaries/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.cli https://smmh.dev/claudewheel/claudewheel-cli/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.clients https://smmh.dev/claudewheel/claudewheel-clients/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.config https://smmh.dev/claudewheel/claudewheel-config/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.constants https://smmh.dev/claudewheel/claudewheel-constants/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.defaults https://smmh.dev/claudewheel/claudewheel-defaults/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.discovery https://smmh.dev/claudewheel/claudewheel-discovery/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.effects https://smmh.dev/claudewheel/claudewheel-effects/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.fuzzy https://smmh.dev/claudewheel/claudewheel-fuzzy/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.guardrail https://smmh.dev/claudewheel/claudewheel-guardrail/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.health https://smmh.dev/claudewheel/claudewheel-health/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.hook_scripts https://smmh.dev/claudewheel/claudewheel-hook_scripts/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.hooks https://smmh.dev/claudewheel/claudewheel-hooks/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.import_ https://smmh.dev/claudewheel/claudewheel-import_/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.install https://smmh.dev/claudewheel/claudewheel-install/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.launch https://smmh.dev/claudewheel/claudewheel-launch/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.migrate https://smmh.dev/claudewheel/claudewheel-migrate/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.mv https://smmh.dev/claudewheel/claudewheel-mv/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.patch_profiles https://smmh.dev/claudewheel/claudewheel-patch_profiles/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.permission https://smmh.dev/claudewheel/claudewheel-permission/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.preflight https://smmh.dev/claudewheel/claudewheel-preflight/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile https://smmh.dev/claudewheel/claudewheel-profile/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile_info https://smmh.dev/claudewheel/claudewheel-profile_info/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile_ops https://smmh.dev/claudewheel/claudewheel-profile_ops/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.profile_store https://smmh.dev/claudewheel/claudewheel-profile_store/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.project_hooks https://smmh.dev/claudewheel/claudewheel-project_hooks/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.pty_runner https://smmh.dev/claudewheel/claudewheel-pty_runner/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.reconcile https://smmh.dev/claudewheel/claudewheel-reconcile/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.renderer https://smmh.dev/claudewheel/claudewheel-renderer/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.scratchpad https://smmh.dev/claudewheel/claudewheel-scratchpad/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.segment https://smmh.dev/claudewheel/claudewheel-segment/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.session https://smmh.dev/claudewheel/claudewheel-session/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.session_registry https://smmh.dev/claudewheel/claudewheel-session_registry/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.shared_store https://smmh.dev/claudewheel/claudewheel-shared_store/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.state https://smmh.dev/claudewheel/claudewheel-state/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.stats https://smmh.dev/claudewheel/claudewheel-stats/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.terminal https://smmh.dev/claudewheel/claudewheel-terminal/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.theme https://smmh.dev/claudewheel/claudewheel-theme/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.tokens https://smmh.dev/claudewheel/claudewheel-tokens/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.ui https://smmh.dev/claudewheel/claudewheel-ui/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.wizard https://smmh.dev/claudewheel/claudewheel-wizard/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel.workspace https://smmh.dev/claudewheel/claudewheel-workspace/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudewheel https://smmh.dev/claudewheel/claudewheel/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> c config https://smmh.dev/claudewheel/cli-config/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c deploy-hooks https://smmh.dev/claudewheel/cli-deploy-hooks/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c health https://smmh.dev/claudewheel/cli-health/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c import https://smmh.dev/claudewheel/cli-import/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c CLI Reference https://smmh.dev/claudewheel/cli-index/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c install https://smmh.dev/claudewheel/cli-install/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c launch https://smmh.dev/claudewheel/cli-launch/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c migrate https://smmh.dev/claudewheel/cli-migrate/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c mv https://smmh.dev/claudewheel/cli-mv/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c patch-profiles https://smmh.dev/claudewheel/cli-patch-profiles/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c permission https://smmh.dev/claudewheel/cli-permission/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c profile https://smmh.dev/claudewheel/cli-profile/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c reconcile-permissions https://smmh.dev/claudewheel/cli-reconcile-permissions/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c reset-options https://smmh.dev/claudewheel/cli-reset-options/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c show https://smmh.dev/claudewheel/cli-show/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c stats https://smmh.dev/claudewheel/cli-stats/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c uninstall https://smmh.dev/claudewheel/cli-uninstall/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> c versions https://smmh.dev/claudewheel/cli-versions/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> API Reference https://smmh.dev/claudewheel/gen-index/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> Getting Started https://smmh.dev/claudewheel/getting-started/ 2026-08-12T00:00:00Z This tutorial walks through installing claudewheel, creating a profile, navigating the segment bar, and launching your first Claude Code session. claudewheel https://smmh.dev/claudewheel/ 2026-08-12T00:00:00Z A TUI launcher for Claude Code that presents a horizontal segment bar for selecting a profile, model, directory, MCP mode, and permissions before launching a session. Selections persist across launches, and the bar adapts to narrow terminals with viewport scrolling and a minimap. Theming https://smmh.dev/claudewheel/theming/ 2026-08-08T00: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. Guardrails https://smmh.dev/claudewheel/guardrails/ 2026-08-05T00: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-08-05T00: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. Configuration https://smmh.dev/claudewheel/config/ 2026-07-29T00: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. Profiles https://smmh.dev/claudewheel/profiles/ 2026-07-29T00: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.