A native macOS app for managing Claude Code configuration.
Settings, profiles, permissions, hooks, MCP servers, sessions, and more — no more hand-editing JSON.
brew install --cask rektoooooo/tap/cc-settingsUpdate later with brew upgrade --cask cc-settings.
Grab the latest DMG from Releases, open it, and drag CC Settings to your Applications folder. The app is code-signed and notarized by Apple — it opens normally, no Gatekeeper warning.
Requires macOS 26.0+, Xcode 16+, and XcodeGen.
git clone https://github.com/Rektoooooo/CC-Settings.git
cd CC-Settings
xcodegen generate
open "CC Settings.xcodeproj" # Cmd+R to build and runClaude Code stores its configuration across JSON files, markdown docs, and folders under ~/.claude/. CC Settings gives you a native macOS UI to manage all of it.
- Every change writes only the field you touched — the app never overwrites your other settings
- Instant saves — no save button, changes are picked up by Claude Code on the next prompt
- Settings Profiles — save and load named configuration snapshots
- Per-project overrides — customize model, permissions, hooks, and more per project with inherit/override toggles
- Global search — find any setting instantly across all sections
| Section | Highlights |
|---|---|
| General | Model family/version picker, profiles, theme, language, effort level, git config, auto-compact, attribution, and more |
| Permissions | Visual permission matrix for all tools, custom pattern rules (e.g. Bash(git push *)), default mode picker |
| Environment | API keys, model overrides, proxy settings, token limits, prompt caching toggles, MCP timeouts |
| Experimental | Extended thinking with budget slider, agent teams, sandbox config (new + legacy), spinner customization, status line |
| Hooks | Pre/Post Tool Use, Prompt Submit, and 20+ other hook types — with matchers, multiple commands, and scope badges |
| HUD | Configure the claude-hud statusline — layout, toggles, thresholds, presets, live ASCII preview |
Save your current settings as a named profile and switch between them. Profiles store the full raw JSON, so unknown CLI keys are preserved. Useful for switching between work/personal configs or testing different setups.
Expand any project in the sidebar to access its settings. Each field shows whether it inherits from global or is overridden locally. Toggle "Custom" to override a setting just for that project — toggle it back to remove the override.
Overridable: model, effort level, output style, shell, permissions, hooks, environment variables, sandbox, worktree, and more.
| Section | Highlights |
|---|---|
| CLAUDE.md | Edit global and per-project instructions with source/preview/split view and templates |
| Session History | 3-column browser: projects, sessions, messages with tool calls, thinking blocks, and search |
| Section | Highlights |
|---|---|
| Commands | Browse, create, and edit slash commands with frontmatter and markdown body |
| Skills | Browse skills with multi-file viewer (markdown, JSON, code, PDF) |
| Plugins | Browse marketplace plugins, view READMEs, copy install commands |
| MCP Servers | Add/edit/remove servers (stdio, SSE, HTTP) with scope support (global + per-project) |
| Agents | Browse and manage agent configurations |
| Rules | View and edit rules with scope awareness |
| Section | Highlights |
|---|---|
| Stats | Usage analytics — sessions, tokens, models, tools, daily activity charts, project rankings |
| Cleanup | Storage dashboard with charts, filter by age, bulk-delete old sessions |
| Version Control | Built-in git: status, staging, commits, history, diffs, pull/push |
CC Settings reads and writes the same files Claude Code uses:
~/.claude/settings.json Settings, permissions, hooks, experimental
~/.claude/settings.local.json Local overrides
~/.claude/CLAUDE.md Global instructions
~/.claude/commands/*.md Slash commands
~/.claude/skills/ Skills
~/.claude/plugins/ Plugins + HUD config
~/.claude/profiles/ Settings profiles
~/.claude.json MCP servers
<project>/.claude/settings.json Per-project overrides
<project>/.claude/CLAUDE.md Per-project instructions
The app uses field-level saves — when you change a toggle, only that specific key is written to the JSON file. All other keys (including ones the app doesn't know about) are preserved. Opening the app never writes anything to disk.
git clone https://github.com/Rektoooooo/CC-Settings.git
cd CC-Settings
brew install xcodegen # if not installed
xcodegen generate
open "CC Settings.xcodeproj"project.yml is the source of truth for build config. After modifying it, run xcodegen generate before building. The .xcodeproj is gitignored.
- swift-markdown — Markdown parsing and rendering. Only external dependency.
MIT — see LICENSE