Crystal — Summary

Crystal (now deprecated, rebranded as Nimbalyst) was an Electron desktop application for managing multiple AI coding agent sessions (Claude Code and Codex) simultaneously against a single repository using git worktrees. Each session operated in an isolated branch/worktree to prevent conflicts, with a full-featured UI including diff viewer, multi-terminal panel system, prompt history, and SQLite-backed session persistence.

Problem it solved: Running parallel AI coding sessions required manual git worktree management and terminal juggling; Crystal automated worktree creation/cleanup, provided a unified interface for comparing approaches, and preserved session context across app restarts.

Distinctive trait: Crystal was the earliest polished Electron app in this batch explicitly purpose-built around the Claude Code SDK's worktree tutorial pattern — each session gets its own git worktree, its own branch, and can be squash-rebased back to main with one click.

Current status: Deprecated in February 2026, replaced by Nimbalyst (https://nimbalyst.com). The repo is archived-in-spirit but not formally archived on GitHub. Version analyzed: 0.3.5 (TypeScript/Electron).

differs_from_seeds: Crystal is closest to superpowers in target tool (Claude Code) but belongs to a completely different archetype — it is a multi-session manager/desktop-app rather than a skills/methodology plugin. Unlike superpowers (14 skills, 1 hook, zero UI surface), Crystal ships no prompt primitives at all; its value is entirely in the Electron GUI, worktree automation, and SQLite session store. Compared to claude-flow (MCP-anchored, 305 tools), Crystal is a thin desktop wrapper that delegates all intelligence to the underlying CLI agents rather than enriching them with tools.

Crystal — Overview

Origin

Created by Stravu (https://stravu.com). Open-sourced under MIT license. First shipped as a reference implementation of Anthropic's own tutorial "Run parallel Claude Code sessions with git worktrees." Version 0.3.5 analyzed; deprecated February 2026 and replaced by the commercial Nimbalyst product.

Philosophy

Crystal's README CLAUDE.md describes it as "a fully-implemented Electron desktop application for managing multiple AI code assistant instances (Claude Code and Codex) against a single directory using git worktrees." The core belief: running multiple AI sessions in parallel against isolated branches, then reviewing diffs and choosing the best approach, is superior to serial single-session development.

Manifesto-style quotes

From CLAUDE.md:

"Crystal provides a streamlined interface for running parallel AI assistant sessions with different approaches to the same problem."

"Each Claude Code session operates in its own git worktree. No merge conflicts, no stepping on each other's changes."

"Squash and rebase to main: Combine all commits and rebase onto main."

Core belief

Parallelism is valuable not just for speed but for comparison — running the same prompt through multiple agents in different worktrees lets developers choose the best approach rather than committing to the first output.

Target users

Individual developers and small teams who want to explore multiple AI-generated solutions simultaneously and merge only the winner.

Crystal — Architecture

Distribution

• Electron desktop app (macOS, Linux, Windows builds via electron-builder)
• No npm global install; users download a release binary or build from source
• Package name: crystal, version 0.3.5

Install

git clone https://github.com/stravu/crystal
cd crystal
pnpm install
pnpm run dev         # development
pnpm run build:mac   # production build

Directory tree

crystal/
├── frontend/        # Vite + React frontend (renderer process)
├── main/            # Electron main process (Node.js)
│   └── src/
│       └── services/
│           └── panels/
│               └── codex/  # Codex CLI integration
├── shared/          # Shared types between main/renderer
├── tests/           # Playwright e2e tests
├── scripts/         # Build helper scripts
├── docs/            # Developer guides (ADDING_NEW_CLI_TOOLS.md, etc.)
└── screenshots/     # App screenshots

Required runtime

• Node.js (Electron bundles its own)
• Git (for worktree operations)
• Claude Code CLI and/or Codex CLI (external, installed separately)

Target AI tools

• Claude Code (primary)
• OpenAI Codex CLI

Key subsystems

• SQLite (better-sqlite3): Persists sessions, prompt history, project configs
• XTerm.js: Terminal emulator for each panel instance
• Panel system: Multiple terminal panels per session, lazy-initialized, state-persisted
• IPC: Electron IPC for real-time streaming between main and renderer
• Git operations: Worktree create/delete, squash-rebase, diff computation (native git CLI)

Config files

• CLAUDE.md (project guidance for AI agents contributing to Crystal itself)
• AGENTS.md (same content for non-Claude agents)
• SQLite database for session/project persistence (runtime, not checked in)

Crystal — Components

Crystal ships no slash-commands, skills, hooks, or MCP servers — its components are UI views and backend services.

UI Views

Backend Services (main process)

Codex Integration

Scripts (build/dev)

No prompts/skills/hooks

Crystal has zero prompt files, zero skills, zero hooks, zero MCP servers. The AI intelligence lives entirely in the external CLI tools (Claude Code, Codex) that Crystal spawns as subprocesses.

Crystal — Uniqueness & Positioning

differs_from_seeds

Crystal is most similar to superpowers in that it targets Claude Code and uses git worktrees for isolation. However, Crystal is architecturally opposite: superpowers injects behavioral methodology (Iron Laws, TDD gates, 14 skills) into the agent's context, while Crystal provides zero behavioral modification and is purely a session/worktree management UI. Compared to claude-flow (MCP-anchored, hive-mind consensus, 305 tools), Crystal is a thin shell with no tool augmentation. Among seeds, the closest functional analog is claude-conductor (Archetype 4 — markdown scaffold), but even there Crystal differs: claude-conductor is a file-based template for a single agent, while Crystal is a multi-session desktop app managing N parallel agents. Crystal introduces a genuinely new archetype in this corpus: "parallel session manager with comparison UX."

Positioning

• The reference implementation of Anthropic's own "run parallel Claude Code sessions with git worktrees" tutorial
• Positioned as a desktop tool for developers who want to A/B test different AI approaches to the same problem
• No methodology, no rules, no enforcement — pure session management and comparison

Observable failure modes

• No automated merge strategy: if two sessions produce conflicting changes, the user must resolve manually
• No quality gate before the user picks a winner: the "best" session is selected by human inspection, not automated validation
• Deprecated: active use is not recommended; Nimbalyst is the successor
• No cross-platform parity: Linux support via AppImage but less tested than macOS

Inspired by

• Anthropic's official git worktrees tutorial
• General Electron multi-terminal app patterns (iTerm2-style split panes cited in README)

Competitors named in README

None explicitly. The README does reference Nimbalyst as the successor.

Status

Deprecated February 2026. Replaced by Nimbalyst (https://github.com/Nimbalyst/nimbalyst).