Crystal - Multi-Session AI Code Assistant Manager

<div align="center"> <h3><a href="https://github.com/stravu/crystal/releases/latest">**Get the Latest Release Here**</a></h3> </div> <div align="center">

</div> <div align="center"> <strong>Crystal lets you use AI on isolated copies of your code so you can work on multiple tasks instead of waiting for your agents to finish.</strong> </div> <br> <br> <div align="center"> <img src="https://github.com/user-attachments/assets/45ca7166-e69a-4ed2-8ef5-ef83dc52ffd6" alt="Run one or more sessions with Claude Code, Codex, or both" width="400"/> <p><em>Run one or more sessions with Claude Code, Codex, or both</em></p> </div> <div align="center"> <table> <tr> <td align="center" width="50%"> <img src="https://github.com/user-attachments/assets/e180691e-aaa3-4171-bdae-3b0459dcc495" alt="Rich output for your agents" width="400"/> <p><em>Rich output for your agents</em></p> </td> <td align="center" width="50%"> <img src="https://github.com/user-attachments/assets/1f64ac92-9158-4e83-997e-6650a9bc9072" alt="Run your code and test before merging" width="400"/> <p><em>Run your code and test before merging</em></p> </td> </tr> </table> </div> <div align="center" style="max-width: 600px; margin: 0 auto;">

https://github.com/user-attachments/assets/5ca66e5b-8d05-4570-8417-5e8dcd7726ef

</div>

---

The Crystal Workflow

1. Create sessions from prompts, each in an isolated git worktree
2. Iterate with your AI assistant (Claude Code or Codex) inside your sessions. Each iteration will make a commit so you can always go back.
3. Review the diff changes and make manual edits as needed
4. Squash your commits together with a new message and merge to your main branch.

---

🚀 Quick Start

Prerequisites

• For Claude Code: Claude Code installed and logged in or API key provided
• For Codex: Codex installed (via npm: @openai/codex or Homebrew) with ChatGPT account or API key
• Git installed
• Git repository (Crystal will initialize one if needed)

1. Create a Project

Create a new project if you haven't already. This can be an empty folder or an existing git repository. Crystal will initialize git if needed.

2. Create Sessions from a Prompt

For any feature you're working on, create one or multiple new sessions:

• Each session will be an isolated git worktree

3. Monitor and Test Your Changes

As sessions complete:

• Configure run scripts in project settings t...