Licensing
Updated June 29, 2026
Getting a license key
When you purchase crystl, a license key is generated and emailed to you automatically. Keys look like this:
ABCD3-XY7KN-QR2MP-8HJVW
No account or login required, just the key.
Activating your license
crystl works on the free plan without a license key. To activate a Guild license:
- Open crystl
- Go to Settings > License
- Paste your license key
- crystl verifies the key and you’re good to go
Your key is stored securely in the macOS Keychain. You won’t need to enter it again unless you reinstall or switch machines.
What the key includes
Each license key is tied to:
- Your email: the one used at checkout
- A plan: determines which features are available
- An expiry date: one year from purchase
Plan comparison
| Free | Guild ($170/year) | |
|---|---|---|
| Prompt Library integration | None | Full access |
CLI — read-only commands & crystl copy | Yes | Yes |
| CLI — control commands (open/close, shard create/rename, send, approve, quest…) | None | Full access |
| Formations | None | Full access |
| iPhone app — from anywhere (relay) | None | Full access |
| iPhone app — same Wi-Fi | Yes | Yes |
| Gems & shards (unlimited on every tier) | Yes | Yes |
| Facet Inserts (unlimited on every tier) | Yes | Yes |
| Isolated shards | Yes | Yes |
| MCP server config | Yes | Yes |
| API key storage | Yes | Yes |
| Split view | Yes | Yes |
| Conversation history | Yes | Yes |
| Terminal GPU rendering | Yes | Yes |
Checking your license
You can check your license status at any time from the crystl menu bar:
crystl > License
This shows your current plan, expiry date, and whether the license is active.
Renewal
crystl uses auto-renewing yearly subscriptions through Stripe. Here’s how it works:
- Automatic renewal: Your license renews automatically each year. No action needed.
- New key on renewal: When your subscription renews, a new license key is emailed to you at your purchase email address from [email protected]. Paste the new key into crystl when prompted.
- Cancel any time: You can cancel your subscription from Stripe’s customer portal. After cancellation, your current license remains active until the end of the billing period.
crystl will notify you 30 days before your license expires. If your license expires and your subscription has been cancelled, crystl will prompt you to resubscribe but won’t lock you out immediately. There’s a short grace period so you don’t lose work.
Offline use
crystl caches your license status locally. You can use crystl offline without issues; it only needs to reach the verification server once every few days. If you’re offline for an extended period, crystl continues to work based on the last cached status.
Moving to a new machine
Copy your license key to your new machine by entering it in Settings > License. If you no longer have your key, check the original email from [email protected] or contact support.
Troubleshooting
| Issue | Fix |
|---|---|
| ”Invalid license key” | Double-check for typos. Keys use letters and numbers only (no O/0 or I/1 ambiguity). |
| ”License expired” | Renew at crystl.dev. Your key will be extended automatically. |
| ”Verification failed” | Check your internet connection. crystl will retry on its own. |
| Lost your key | Search your email for a message from [email protected], or contact support. |