Crystal is an Electron desktop application designed for developers to manage AI-assisted development workflows using Claude Code. It allows users to run multiple Claude Code sessions in parallel, each isolated within its own Git worktree, facilitating testing, comparison of approaches, and streamlined iteration on code.

How It Works

Crystal leverages Git worktrees to create isolated environments for each Claude Code session. This approach ensures that AI-generated code changes for different tasks or iterations do not interfere with each other. The application integrates Git operations like committing, diff viewing, squashing, and rebasing directly into the workflow, enabling users to track changes, revert to previous states, and cleanly integrate AI-generated code into their main branches.

Quick Start & Requirements

• Installation: Download pre-built binaries for macOS from the latest release. Building from source requires pnpm.
• Prerequisites: Claude Code installed and logged in (or API key provided), Git installed, and a Git repository (can be initialized by Crystal).
• Development: To develop Crystal itself, use a separate data directory (CRYSTAL_DIR=~/.crystal_test) to avoid conflicts.
• Documentation: Additional details are available in CLAUDE.md and the docs directory.

Highlighted Details

• Parallel session management for multiple Claude Code instances.
• Git worktree isolation for each session.
• Built-in Git operations: rebase, squash, diff viewing.
• Session persistence to resume conversations.

Maintenance & Community

• Join the Discord server for community support and discussion.

Licensing & Compatibility

• Licensed under the MIT License.
• Crystal is an independent project and not affiliated with Anthropic.

Limitations & Caveats

• The application is primarily documented for macOS; Windows and Linux support may require building from source.
• Requires separate installation and configuration of Claude Code.