#Changelog

#0.24.2

Remove the claude-fable-5[1m] model option, which could never differ from plain Fable 5

#Fixes

• **Removed the claude-fable-5[1m] model option.** Fable 5 runs at 1M context unconditionally, so the suffix was discarded by Claude Code and the option could never differ from plain claude-fable-5 — while making an entitlement wall look like the reason. Existing options.json files are cleaned automatically.

#0.24.1

Unblock Fable 5 on token-authed profiles by injecting the declared plan tier

#Fixes

• Corrected publish documentation. The contributor docs claimed CI publishes to both npm and PyPI via OIDC Trusted Publishing with no tokens; in fact only PyPI is OIDC and npm requires the NPM_TOKEN secret.
• Valid theme file example. The theme file structure example in the theming docs used { ... } placeholders and was not valid JSON; it is now a copyable skeleton with a real key per section.
• Fable 5 works on token-authed profiles. Profiles can declare subscriptionType and rateLimitTier in their tokens.json entry; claudewheel injects them into the launch environment. Without them Claude Code resolves the plan tier to null under setup-token auth and walls Fable 5 behind a usage-credits dialog offering no way forward.

#0.24.0

The effects regime -- a real --dry-run and confirmation only where it is earned -- plus the vanilla default profile, approved project hooks, title-based resume, Opus 5, launch-time guardrail healing, scratchpad cleanup, and a full documentation site.

#Breaking

• **patch-profiles and reconcile-permissions now prune to exact canonical.** The old additive, extras-preserving behavior is gone; user-added hook or disallowed-tool extras are removed on sync.
• strictcli effects regime. Every command is now classified read_only or mutating: read-only commands (health, versions, show, profile show, profile check-tokens, permission list) run unchanged, while mutating commands confirm before they write and accept the framework's --dry-run. The per-command --dry-run flags on stats, mv, import and patch-profiles, and reconcile-permissions' --apply, are replaced by that single framework flag.
• **No more Proceed? [y/N] in front of routine work.** Confirmation is no longer inferred from a command being mutating -- it is declared. c launch, deploy-hooks, install, mv, import and the bare claudewheel that starts every session run straight through and prompt for nothing. The commands that do declare it confirm first and refuse on a non-interactive stdin unless you pass --approve-consequential (the skip flag, replacing --yes).

#Features

• Launch-time guardrail healing. Every launch now reconciles profile and shared guardrail settings (hooks, disallowed tools, deny/ask rules) to the canonical model, so upgrades can no longer leave stale safety settings on disk.
• Wizard token hardening. Pasted tokens are entered masked (never echoed), checked for the sk-ant- format before any network call, and recorded with an honest "expiry unknown" marker instead of a fabricated one-year expiry.
• Resume by session title. cw -r now accepts a session title (as printed by Claude Code's resume hint, e.g. after /fork) in addition to a UUID, resolving it across project directories with a disambiguation list on collisions.
• Opus 5 support. claude-opus-5 is available in the model picker, and launches are blocked with an actionable message when the selected model requires a newer Claude Code binary than the one in use (needs >= 2.1.219).
• Approved hooks. cw now detects hooks contributed by a target project's .claude/settings.json/settings.local.json, shows them for one-key approval on first sighting or any change, and refuses non-interactive launches with unapproved hooks — project hooks are never silently trusted again.
• Scratchpad cleanup at launch. Interactive launches now offer confirmed deletion of /tmp scratchpad directories untouched for 14+ days (with sizes and ages); declining snoozes the prompt for 7 days. Nothing is ever deleted without confirmation.
• Vanilla default profile. ~/.claude now appears as a launchable "default" profile whenever it exists (no longer requiring a credentials file — fixes invisibility on macOS-Keychain setups), launches byte-for-byte vanilla (no config-dir override, no token injection, zero writes), shows as "managed by Claude Code", and offers a one-time opt-in to inject cw guardrail hooks.
• Stale token surfacing. Token entries whose profile no longer exists are now reported by health, shown as a persistent TUI notice with a review-and-remove page (press T), and repairable via profile fix-auth.
• **--dry-run now previews instead of writing.** Every subprocess launch, filesystem mutation and network call routes through one effects chokepoint, so c --dry-run reconcile-permissions, --dry-run deploy-hooks, --dry-run install and the profile create/delete/rename commands record what they would do and leave ~/.claudewheel/ untouched.
• CLAUDE.md now states which commands confirm and which do not. A new "Confirmation and preview" section documents the three consequential commands, the --approve-consequential skip flag, the framework-owned flag quartet, and what --dry-run guarantees.
• A real documentation site. claudewheel now ships a getting-started tutorial plus guides for profiles, theming, configuration, and health checks and preflight, and every module reference page carries written prose instead of a bare symbol skeleton.

#Fixes

• Fixed: two Claude Code versions installing at once could corrupt each other. c install 2.1.220 and c install 2.1.221 both staged their download into a file named 2.1.downloading, so one could rename the other's half-written bytes into place under a checksum that was never verified against them. Each install now stages into its own <version>.downloading.
• **c --dry-run install no longer claims it installed anything.** It now says what it would download and where it would land, above the framework's would-do log.
• **reconcile-permissions and patch-profiles confirm before writing.** Both rewrite every managed profile plus shared-settings.json to exactly canonical, pruning hand-added permission rules, hook entries and disallowedTools with nothing backed up. They now declare themselves consequential, so the CLI confirms first and refuses with pass --approve-consequential to confirm when there is no terminal. --dry-run still previews ungated.
• **--dry-run no longer claims work it did not do.** Ten commands -- profile delete, profile rename, profile create, deploy-hooks, uninstall, reset-options, migrate, permission add, permission remove and profile fix-auth -- printed past-tense success text above the would-do log during a preview. They now narrate in the conditional ("Would delete profile 'x'."). migrate additionally ignored --dry-run in its own reporting entirely.
• The push guardrail no longer points at a command that does not exist. Its escalation advice named rlsbl push, which rlsbl removed; it now names rlsbl release run only.

#0.23.3

mv now migrates nested project sessions and rewrites githubRepoPaths

#Fixes

• **mv now migrates nested projects.** Moving a directory that contains other Claude Code project dirs migrates every descendant's session data (encoded project dirs, .claude.json project keys, JSONL cwd references) and rewrites githubRepoPaths entries pointing into the moved tree. Undecodable or ambiguous encoded dirs and missing descendant destinations abort the move before anything is touched.

#0.23.2

Fixes crashes on malformed install manifests; hardens the toolchain behind the scenes.

#Breaking

• Breaking: strictcli v0.29.0 migration. The _bind wrapper now accepts ctx as first parameter, threading it through to strictcli's new handler contract.

#Fixes

• Fixed crash on malformed install manifests. Installing a Claude Code version whose server manifest is missing or malforms expected fields (checksum, platforms, entry shapes) no longer crashes with a traceback; the CLI reports a clean error and the TUI shows the install-failed page.

#0.23.1

Fixes a TUI crash when installing a Claude Code version from the launcher.

#Features

• Client selection step. The interactive launcher now prompts for the launch client (claude or miniclaude) with the configured default_client pre-selected; pass --client to skip the step. Unavailable clients are marked (not installed), and for non-Claude clients the version step is skipped.

#Fixes

• Launching with --client miniclaude no longer fails when a Claude version was remembered from a previous launch or set as a config default; the version is a Claude-only input and is now ignored for non-Claude clients.
• Fix. Launching with --client miniclaude no longer fails when MCP strict mode was remembered from a previous launch; MCP selection is now treated as a claude-only input and ignored for non-Claude clients, alongside version and default flags.
• Fixed TUI crash when installing a Claude Code version. Selecting a version to install from the launcher no longer crashes; failed downloads now show an "Install failed" page.

#0.23.0

Launch-target client adapters: the new --client flag can launch alternative clients (miniclaude) with mapped profile/model/permission selections.

#Features

• Launch target selection. New --client flag on claudewheel launch can start the miniclaude REPL client (--client miniclaude) instead of the official claude binary; the default claude preserves existing behavior.

#0.22.1

Fixes from the post-refactor hardening pass: clone-from-default profile creation, honest health reporting, self-cleaning failed profile creation, and an exact hooks-wired check.

#Fixes

• Cloning from the default profile now works. The profile wizard's clone-from-default option previously produced an empty-base profile (and falsely reported its settings source); it now clones the real ~/.claude settings.
• Health no longer claims inode cleanup it could not persist. On read-only workspaces the inode check now reports that stale entries were found but not persisted, instead of 'cleaned'.
• A failed profile creation cleans up after itself. If profile creation fails partway, the partially-created profile directory is removed so a retry works, instead of failing with already-exists.
• hooks-wired now verifies the actual hook command path. The health check previously matched hook scripts by name substring and passed even when hooks pointed at a nonexistent directory; it now requires the exact canonical command.

#0.22.0

Read-only profile resolution (safe on read-only mounts and headless servers) and the Workspace refactor; corrupt token stores now fail loudly.

#Breaking

• Corrupt tokens.json is now a hard error. resolve_profile raises instead of silently returning an env without a token; profiles resolve purely from the on-disk layout (persisted options.json metadata is no longer consulted).
• Unknown or stale profile names fail launches loudly. Launching with a profile that no longer exists raises a clear error instead of silently falling back to ~/.claude; profile locations are derived from the profile directory, never from persisted metadata.

#Features

• CLAUDEWHEEL_CONFIG_DIR. New env var overriding the workspace root (default ~/.claudewheel) for programmatic and containerized consumers.
• Health detects relocated workspace roots. A new health check flags profile hook commands pointing at a different scripts directory than the current workspace; patch-profiles fixes them.

#Fixes

• resolve_profile no longer writes. Profile resolution performs zero filesystem writes and no terminal queries — safe on read-only mounts and headless servers.
• migrate now supports the default profile. Session data can be migrated to and from the ~/.claude default profile; previously it errored as if the profile did not exist.
• options.json no longer stores profile locations. A one-time migration removes the legacy profile metadata block; profile locations are always derived from the profile directory.

#0.21.0

Paste token option in wizard auth flow

#Features

• New feature. Wizard now offers a 'Paste token directly' option for users with pre-existing API tokens.

#0.20.1

Guardrail correctness fixes, a repaired --dump-schema/--version, and new guardrail documentation.

#Features

• New Guardrails documentation page covering the four enforcement tiers, subagent-vs-main-agent handling, and the command-string caveat, with an always-in-sync per-rule reference table generated from the guardrail model.
• **claudewheel health now detects deployed-hook drift** — it warns when the hook scripts installed for a profile differ from the current model.

#Fixes

• Guardrail fixes. Remote-branch deletion via the colon-refspec form (git push origin :branch) is now hard-denied for everyone, matching --delete; a cross-separator false-positive that could wrongly block chained pushes is fixed; and kill/pkill advice no longer fires spuriously on commands like npm run kill.
• **Fixed claudewheel --dump-schema**, which previously failed because the CLI injected an implicit launch subcommand before the flag was parsed.
• **Fixed claudewheel --version** reporting a stale version in editable/source checkouts; it now reads the project's actual version from package.json.

#0.20.0

Subagent-aware command guardrails, a reconcile-permissions command, and a canonical-drift health check.

#Features

• New patch-profiles command syncs existing profiles and shared settings to canonical hook/disallowedTools defaults
• **New reconcile-permissions command.** Reconciles each profile's permission rules and the shared defaults to the canonical guardrail set: adds missing rules, removes obsolete ones, and strips dead allow entries. Requires an explicit --dry-run or --apply.
• Guardrail hooks now distinguish subagents from the main agent. Escalate-tier commands (git push, git reset, rebase, saferm purge, gh workflow run, forced switch) are hard-denied for subagents with instructions to escalate to the parent agent, while the main agent falls through to a confirmation prompt. git checkout is steered to git switch, and kill/pkill now trigger advice to build graceful stop scripts.
• **New canonical-drift health check.** claudewheel health now reports when a profile's permission rules or hook wiring diverge from the canonical guardrail set.
• Added Claude Opus 4.8 model variants to the model selection defaults.

#Fixes

• Health check /tmp/claude now measures real tmpfs usage (excludes symlink targets, uses block size); threshold lowered to 1 GB
• Fixed the rm hard-block hook emitting invalid JSON (rm commands were never blocked) and hardened it to catch sudo/env/xargs/find -exec rm

#0.19.1

Profile rename command, inline auth-shadow fix on inspect page, faster detection, and a state-save race fix.

#Features

• Terminal background detection timeout reduced from 1s to 500ms, halving worst-case startup latency on unsupported terminals.
• Profile inspect page now offers to fix auth shadow inline when detected (press f).
• New profile rename <old> <new> command with automatic recovery if interrupted mid-rename.

#Fixes

• Fixed a race where concurrent sessions could lose the remembered browser choice on state save.

#0.19.0

CLI profile command group, auth shadow fix, hook guard, rate-limit tier, live theme switching, and online token validation.

#Breaking

• Breaking. Profile commands renamed to a group: new-profile -> profile create, delete-profile -> profile delete, show-profile -> profile show. Old names print a redirect and exit.

#Features

• New profile fix-auth command strips session credentials that shadow a long-lived token, and a health check detects the condition.
• New hook-block-unsafe-commands hook blocks raw git add, git stash, git restore, git checkout --, and rm in AI agent sessions, directing to safegit/saferm.
• Rate-limit tier is captured from session-login credentials and exposed to downstream tools (e.g., howmuchleft) via a .credentials.json stub at launch.
• Version install uses a themed confirmation dialog and result page instead of a bare text prompt.
• New profile check-tokens command validates stored tokens against the Anthropic API and reports per-profile status.
• Live theme switching: terminals supporting Mode 2031 (kitty, Ghostty, foot, VTE 0.82+) automatically switch claudewheel's theme when the OS dark/light mode changes mid-session.

#Fixes

• Fixed CSI decoder to handle private-mode sequences (ESC[?...) without leaking bytes into the input stream.
• SIGTERM and SIGHUP are now handled cleanly during forms and PTY sessions, preventing terminal corruption on kill.

#0.18.2

Profiles now launch without a login screen, and the theme adapts to light/dark terminals automatically.

#Features

• Terminal background color is now auto-detected at startup (via OSC 11). Light-terminal users automatically get the light theme without manual configuration.

#Fixes

• Profiles created via the wizard now work immediately without Claude Code showing a login screen. Previously, CC's onboarding gate blocked token-injected profiles.
• Form text is now fully theme-driven — readonly fields and radio selections no longer use hardcoded colors that were invisible on light backgrounds.

#0.18.1

Hint bar now automatically reflects available keybindings and wraps on narrow terminals.

#Features

• Keyboard shortcuts are now shown automatically in the hint bar based on current context — new bindings no longer require manual hint-string updates.
• Hint bar wraps to a second line on narrow terminals instead of truncating.

#0.18.0

Themed form system, zero-paste token capture with API validation, profile inspect and delete in the TUI, and six new internal modules.

#Features

• Continuous fullscreen create-profile flow. The profile wizard, auth method/browser forms, and a new creation summary page now run as one uninterrupted fullscreen session (no more bouncing between the TUI and scrollback), themed via the new forms theme section. The claude auth login / setup-token subprocess and token paste open in a temporary cooked window and return to the session. The CLI new-profile path gets the same flow.
• Zero-paste token auth with hard validation. The long-lived token flow now captures claude setup-token output directly -- no manual paste needed -- and validates every token against the API before saving. Tokens the API rejects (401) are never saved (one manual re-paste is offered); when the API is unreachable, saving unvalidated requires an explicit choice and is reported as "unverified". The pre-launch auth prompt now launches only on an explicit skip.
• Profile inspect. Press i on the profile segment to open a fullscreen inspection page for the focused profile, or run c show-profile <name> from the CLI. The report covers registration, credentials, token expiry, shared-dir symlink health (with a danger flag for real data at shared names), settings/permission summary, active session count, and disk usage.
• TUI profile delete. Press Ctrl-D or Delete on the profile segment to delete the focused profile after an informed confirmation (Cancel default-focused). Profiles holding real data at shared-dir names are hard-blocked with a pointer to the new delete-profile --force-delete-data CLI flag -- the TUI offers no override.

#Fixes

• Fix: tokens.json no longer loses its 0600 permissions when a token is updated or a profile is deleted (previously triggered health-check warnings after any token update). options.json, state.json, and inodes.json likewise keep their existing permissions across updates, and a corrupt tokens.json now produces a clear error instead of a crash.
• Fixed silent data loss on profile delete. delete-profile used to rmtree shared-dir names (e.g. projects/) even when they were real directories holding conversation data instead of symlinks. Deletion now refuses with the at-risk dir names; the built-in default profile is refused outright; profiles on disk but missing from options.json can now be deleted; a stale last_config profile reference is purged from state.json.
• Fixed a bug where Delete, PgUp, PgDn, and Insert keys leaked stray bytes into the search buffer. Also added support for parametric Shift-Tab (ESC[1;2Z).
• Fixed a bug where updating tokens.json lost its restrictive file permissions (0600 reverted to 0644 on every write).

#0.17.0

Auth flow UX overhaul: wizard-style prompts, browser choice with copy-URL option, remembered browser, and return-to-TUI after auth.

#Features

• The auth setup prompt is now an arrow-key selection form matching the wizard's style. Esc safely cancels instead of skipping auth.
• Auth setup now lets you choose which browser to open (auto-detected from native, flatpak, and snap installs) or copy the login URL instead of opening any browser.
• After authenticating a profile from the launch intercept, you return to the segment bar (with a status flash) instead of being dropped straight into Claude Code. Only the explicit "Launch without auth" option launches directly.
• Your browser choice for auth is remembered and pre-focused on the next auth flow.

#Fixes

• Long-lived token paste now strips all whitespace and linebreaks automatically, so tokens copied from the terminal with wrapping artifacts work correctly.

#0.16.1

Launching an unauthenticated profile now prompts for auth setup before starting Claude Code.

#Features

• Launching an unauthenticated profile now prompts for auth setup (session login, long-lived token, or skip) before starting Claude Code.

#0.16.0

Profile wizard overhaul: new profiles appear instantly, inline auth setup, and visual indicators for unauthenticated profiles.

#Breaking

• Breaking. Renamed --force to --force-delete (delete-profile) and --force-overwrite (deploy-hooks). Boolean flags now require explicit --flag/--no-flag where no default is set.

#Features

• Profile discovery now accepts profiles with only settings.json, so newly created profiles appear immediately without requiring auth setup first.
• Unauthenticated profiles are visually dimmed in the segment bar, indicating they need auth setup.
• Profile wizard now offers inline auth setup (session login, long-lived token, or skip) immediately after profile creation.

#Fixes

• Dependency installation no longer requires a machine-local checkout: uv.lock previously carried a local path for strictcli, breaking installs and CI outside the author's machine. It now resolves from PyPI (strictcli 0.24.0).
• Newly created profiles now appear in the segment bar immediately after the wizard completes, without requiring a restart.

#0.15.1

Thread safety fix for background discovery and wizard UX overhaul

#Features

• Wizard UX overhaul. Collapsible Advanced toggle hides 6 checkboxes by default, Enter from Name field submits, persistent error display, context-sensitive keyboard hints, Shift-Tab backward navigation, improved visual clarity (bracketed text input, bold radio selections).

#Fixes

• Fix. Background discovery thread no longer shares mutable state dict with the main thread; uses a deep copy to prevent race conditions on npm version cache writes.

#0.15.0

Option provenance architecture: SegmentState separates discovered, pinned, and default options with staleness policies, value-based selection, deferred discovery apply, and a provenance overlay

#Features

• Staleness policy. Discovery registry entries now carry verify callbacks; set_discovered uses them to retain values that still exist on disk when a re-scan omits them.
• Directory discovery. Recent dirs are now validated (must exist on disk) and stale entries are pruned from state. Static values no longer mixed into discovery results.
• Virtual '+' button. The '+' creation sentinel is now a virtual UI element, no longer stored in segment state collections. Freeform values are promoted from ephemeral to pinned on launch.
• Deferred discovery apply. Slow discovery results for the focused segment are now buffered and applied on defocus, preventing option list disruption while the user is interacting. A pending indicator (*) appears in the segment label when results are waiting.
• Provenance overlay. Press ? to toggle a source overlay on fan-out options: * discovered, ^ pinned, . default, ~ ephemeral. The status bar shows a legend while active.
• Docs. Added installation instructions (pipx/uv) and deprecation notice for the old Node/npm package.

#0.14.0

Add import command for importing session data from external Claude Code directories

#Features

• New command. claudewheel import imports Claude Code session data from external directories (e.g., Windows backups) into the shared store, with cross-OS path rewriting, collision detection, reid support, and dry-run mode.

#0.13.1

Instant TUI startup via async discovery, KeyboardInterrupt fix, SEO improvements

#Features

• Improvement. TUI launches instantly. Slow discovery calls (GitHub auth, npm versions) now run in a background thread instead of blocking startup.

#Fixes

• Fix. Ctrl-C during npm version fetch no longer produces a traceback.

#0.13.0

Proactive directory rename detection via inode tracking

#Features

• New feature. Proactive directory rename detection via inode tracking. On every launch, claudewheel records the project directory's inode. The health check detects when a recorded path was renamed and suggests claudewheel mv --post-hoc to fix it.

#0.12.0

Fable 5 model support, model auto-sync, full orphan scan for --cont

#Features

• New feature. Model list now auto-syncs from defaults on startup. New models added to claudewheel are automatically available without resetting options.
• New feature. Added Fable 5 (claude-fable-5 and claude-fable-5[1m]) to the default model list.
• Improvement. --cont now scans all orphaned session directories, not just same-parent. Cross-parent directory renames are now detected.

#0.11.0

mv now renames directories by default, --post-hoc for session-only migration

#Breaking

• Breaking. mv now renames the directory on disk by default, then migrates sessions. Use --post-hoc for session-only migration (the old behavior).

#0.10.1

CI workflow improvements: idempotent publish steps for npm and PyPI

#Fixes

• Fix. CI publish workflows are now idempotent -- re-running a partially failed publish no longer fails on already-published packages.

#0.10.0

New permission command group for managing profile permission rules

#Features

• New command group. permission add, permission remove, and permission list subcommands for managing profile permission rules from the CLI.

#0.9.1

--cont interception, mv merge fix, cleaner dry-run UX

#Features

• New feature. --cont now detects directory renames the same way --resume does, scanning for orphaned sessions in sibling directories.
• Improvement. Resume/cont interception shows the claudewheel mv command when the old path still exists, and uses a concise human-readable dry-run summary instead of per-file log spam.

#Fixes

• Bug fix. mv now merges sessions into an existing target directory instead of silently skipping the move.

#0.9.0

Rename redir to mv, add resume interception for directory renames, fix path encoding bug

#Breaking

• Breaking. Renamed redir command to mv.

#Features

• New feature. Resume interception: when --resume can't find a session under the current directory, claudewheel searches the shared store, detects directory renames, and offers to move sessions to the new path.

#Fixes

• Bug fix. Path encoding now replaces both / and . with -, matching Claude Code's internal encoding. Previously, dotfile paths (e.g. ~/.claude-common) would encode incorrectly.

#0.8.0

Rename gc command to stats

#Breaking

• Renamed. gc command renamed to stats to reflect its actual purpose (reporting shared-store statistics).

#0.7.0

Remove profile attribution system, add --picker flag, unify shared settings

#Breaking

• Breaking. Removed the profile attribution system (hook-stamp-origin, xattr stamping, sentinel files, origins log). The system had unfixable race conditions and 30% of files could never be attributed.

#Features

• New flag. --picker opens the Claude session resume picker without requiring a session ID argument.
• Unified shared settings. Replaced per-profile profile-defaults.json with a single shared-settings.json and drift detection.
• deploy-hooks --force. Added --force flag to overwrite existing hook scripts.

#Fixes

• Health check. Removed xattr-coverage and hook-integrity checks; streamlined hooks-wired to only verify hook-timestamp.

#0.6.1

Consolidate shared data and eliminate ~/.claude-shared/ and ~/.claude-common/

#Breaking

• Shared data consolidated. Session data, skills, and scripts moved from ~/.claude-shared/ and ~/.claude-common/ into ~/.claudewheel/. Both old directories eliminated.

#Fixes

• Fix. Profile origins log now correctly read from ~/.claudewheel/ instead of stale ~/.claude-common/ path.

#0.6.0

Profile centralization, hook management, worktree isolation, docs website

#Breaking

• Profile directories moved. Profiles now live at ~/.claudewheel/profiles// instead of ~/.claude-/. A startup warning appears if old-style directories are detected.

#Features

• New command. deploy-hooks auto-creates hook scripts at ~/.claudewheel/scripts/ from built-in templates.
• Settings drift detection. Health check compares profiles against a canonical shared-settings.json and reports differences.
• Worktree isolation guard. PreToolUse hook blocks the Agent tool from using worktree isolation, preventing multi-session conflicts.
• Cron tools enabled. CronCreate, CronDelete, CronList, and ScheduleWakeup removed from disallowed tools.
• Documentation website. Live docs site at claudewheel.smmh.dev with auto-generated API reference, CLI reference, and branding.

#0.5.0

Strictcli compatibility fix and config-directory rename to ~/.claudewheel/.

#Breaking

• Config directory renamed from ~/.claudelauncher/ to ~/.claudewheel/. Run mv ~/.claudelauncher ~/.claudewheel before upgrading or claudewheel will scaffold a fresh empty dir on next launch.

#Fixes

• Fix startup crash from strictcli guardrail; -s now errors on duplicate segment keys (including conflicts between an individual segment flag and -s) instead of silently dropping the earlier value.

#0.4.5

#Fixes

• Fix. resolve_profile() now runs option discovery before reading metadata, fixing programmatic profile resolution from external callers.

#0.4.4

• No user-facing changes.

#0.4.3

#Fixes

• Fix. Profiles set up before claudewheel (without .credentials.json) were invisible to health checks and the TUI profile picker. They are now discovered via tokens.json.
• Fix. Compatibility with strictcli 0.5.0 (MutexGroup is now always required; session flags moved to a Tag with manual mutual-exclusion check).

#0.4.2

• No user-facing changes.

#0.4.1

#Fixes

• CI fix. Resolved dependency resolution failure by removing local path override for strictcli.

#0.4.0

#Breaking

• Python 3.11 required. Bumped minimum Python version from 3.10 to 3.11 for strictcli compatibility.

#Features

• New API. resolve_profile(name) returns environment variables (CLAUDE_CONFIG_DIR, CLAUDE_CODE_OAUTH_TOKEN) for a given profile, enabling programmatic consumers like claudestream.
• CLI rewrite. Migrated from argparse to strictcli with typed subcommands, mutex groups, and structured flags.

#Fixes

• Print mode hygiene. Print mode (-p) now skips health checks and state writes, preventing TUI default pollution and stderr noise for programmatic callers.