Claude Profiles

Effortlessly manage multiple Claude Code configurations. Claude Profiles is a beautiful native macOS application that lets you create, switch between, and manage different Claude Code configurations without manual file shuffling.

Perfect for developers who work with:

• Multiple API providers (Anthropic, Gemini, GLM, custom endpoints)
• Different projects with unique settings
• Testing various model configurations
• Team environments with shared settings

Note

Designed for macOS 14.0+ (Apple Silicon only) — Built with native SwiftUI for a truly Mac-like experience.

---

Features

• 🎯 Native macOS Experience — Clean, familiar interface built with SwiftUI
• ⚡ Instant Profile Switching — Switch configurations with one click, no restarts needed
• 🔐 Secure Credential Management — Your API keys stay local, stored in your config directory
• 📝 Built-in JSON Editor — Edit configuration files directly within the app
• 🎨 Tactical Design — High-contrast, utilitarian aesthetic (Sovereign Grid style)
• 💾 Automatic Backups — Creates ZIP backups before profile changes
• 🔍 Profile Validation — Ensures JSON syntax is valid before saving
• 📂 Config Directory Selection — Point to any Claude Code config directory
• 🔄 Persistent State — Remembers your last active profile across app restarts

Installation

Requirements

• macOS 14.0 (Sonoma) or later
• Apple Silicon (M1/M2/M3/M4) — Intel Macs are not supported
• Claude Code CLI installed and configured

Download Pre-built Release

1. Go to the Releases page
2. Download the latest ClaudeProfiles.zip
3. Extract and drag ClaudeProfiles.app to /Applications
4. Launch the app

Note: The app requires sandbox permissions to access your Claude Code configuration directory.

Build from Source

# Clone the repository
git clone https://github.com/andreyshipilev/claude-profiles.git
cd claude-profiles/ClaudeProfiles

# Build using the provided script
./build.sh

# Or build with Xcode
open ClaudeProfiles.xcodeproj
# Press Cmd+R to build and run

The built application will be at ./build/Build/Products/Debug/ClaudeProfiles.app

Usage

First Launch

1. Select Config Directory

   • On first launch, you'll be prompted to select your Claude Code configuration directory
   • This is typically ~/.claude/
   • The app will create a security bookmark for persistent access

2. Profile Detection

   • The app automatically detects existing configurations
   • Your current settings.json becomes the "Default" profile
   • Other JSON files in .claude-profiles/stored_profiles/ are imported

Creating Profiles

1. Click the "NEW PROFILE" button
2. Enter a Display Name (e.g., "Gemini", "Work Project")
3. Optionally add a Description
4. Choose a Color for visual identification
5. Select a profile to Clone From (optional)
6. Click "CREATE"

Switching Profiles

• Click on any profile card to make it active
• The active profile is highlighted
• Your settings.json is automatically updated with the selected profile's configuration
• All other profiles are stored in .claude-profiles/stored_profiles/

Editing Configuration

1. Select a profile from the dropdown in the Editor tab
2. Modify the JSON configuration
3. Click "FORMAT" to beautify the JSON
4. Click "SAVE" to persist changes

Deleting Profiles

1. Select the profile you want to delete
2. Click the "DELETE" button
3. Confirm the deletion
4. Note: You cannot delete the currently active profile

Project Structure

ClaudeProfiles/
├── ClaudeProfiles.xcodeproj    # Xcode project
├── ClaudeProfiles/
│   ├── ClaudeProfilesApp.swift  # App entry point
│   ├── Utils/
│   │   └── ProfileManager.swift # Core profile management logic
│   ├── Views/
│   │   ├── MainView.swift       # Root view with tabs
│   │   ├── JSONEditorView.swift # JSON configuration editor
│   │   ├── CreateProfileSheet.swift
│   │   └── SettingsView.swift
│   ├── Models/
│   │   └── Models.swift         # Data models (ProfileMetadata, AppState, etc.)
│   ├── DesignSystem/
│   │   ├── TacticalColors.swift
│   │   ├── TacticalTypography.swift
│   │   └── TacticalComponents.swift
│   └── Assets.xcassets/         # Images, icons, colors
├── build.sh                     # Build script
└── README.md

Architecture

State Management

• ProfileManager (@ObservableObject): Manages all profile operations
  • AppState: Holds profiles, active profile, settings
  • Persists to ~/.claude/.claude-profiles/metadata.json
  • Uses security-scoped bookmarks for sandbox access

File Storage

~/.claude/
├── settings.json                    # Active profile (symlinked/copied)
└── .claude-profiles/
    ├── metadata.json                 # Profile registry
    ├── state.json                    # Active profile tracking
    ├── stored_profiles/              # Inactive profiles
    │   ├── gemini.json
    │   ├── default.json
    │   └── ...
    └── backups/                      # Automatic backups
        ├── claude-profiles-2024-01-08.zip
        └── ...

Design System

The app uses a Tactical Utilitarian / Sovereign Grid design language:

• High contrast borders and backgrounds
• Monospaced body text for technical content
• Serif headlines for authority
• No rounded corners — sharp edges only
• Monochromatic palette with color accents

Development

Prerequisites

• Xcode 15.0 or later
• macOS 14.0 SDK
• Swift 5.9+

Building

# Debug build (faster compilation)
./build.sh

# Release build (optimized)
xcodebuild -project ClaudeProfiles.xcodeproj \
  -scheme ClaudeProfiles \
  -configuration Release \
  build

Code Style

• Follow Swift API design guidelines
• Use SwiftUI for all UI components
• Maintain the Tactical design aesthetic
• Add logging with OSLog for debugging

Troubleshooting

App won't open profiles

1. Check Console.app for errors (filter by "ClaudeProfiles")
2. Verify your config directory is accessible
3. Ensure metadata.json is valid JSON

Profiles not persisting

• The app requires security-scoped bookmark access
• Re-select your config directory if prompted
• Check ~/.claude/.claude-profiles/ exists and is writable

Sandbox Issues

If you encounter sandbox-related errors:

# Check the app's sandbox entitlements
codesign -d --entitlements - /Applications/ClaudeProfiles.app

Roadmap

• Profile export/import
• Profile templates
• Quick Switch via global hotkey
• Menu bar integration
• Cloud sync (iCloud, Dropbox)
• Profile groups/tags
• Diff view between profiles

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Credits

Built with:

• SwiftUI — Native macOS UI framework
• Apple AppKit — System-level integration
• Foundation — File management and JSON handling

Design inspiration:

• Tactical Utilitarian — Sovereign Grid design language
• Bento Grid — Modern layout patterns

License

MIT License — see LICENSE for details.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Made with ❤️ for the Claude Code community