Skip to main content

get crystl on your iphone! manage and schedule your agents when you're out and about. learn more ×

featuresresources pricing about search

get started free sign in dashboard

back

features

orchestratemonitorworkspaceconfigure

back

orchestrate

gems & shards agent orchestration parallel sessions crystl quest hero shards schedule agents automation

back

monitor

floating cards agent activity panel history navigator token tracking accounts & usage project optimizer cavrn terminal

back

workspace

crystal rail crystl on iphone workbench markdown editor screenshot bar copy bar remote development split view

back

configure

open models facet inserts agent file editor formations MCP servers keys

back

resources

librarylearnsupport

back

library

all skills agent blocks files prompts commands heroes questlines

back

learn

CLI coding agents docs guides blog

back

support

contact report a bug join us on Slack

back

Type to search docs, guides, skills, prompts, and more.

changelog

What's new in each release of crystl.

2.277.0

November 6, 2026

• The rail position popup in settings → general → appearance now follows the Window menu. Moving the rail from the menu while settings was open left the popup showing the old edge until settings was reopened.

2.276.0

November 6, 2026

• A card your agent sends with crystl card now stays on screen until you dismiss it. Before, a plain card folded into the summary strip after 40 seconds, so an agent could say "I sent you a card" and you would look up at an empty screen. Cards with a button or a question already stayed; now every agent card does.

2.275.0

November 6, 2026

• Roll back an update with one click. When an update installs, crystl keeps the version it replaced. "roll back to …" in the app menu, or the same button in settings → general → startup, quits and reopens on the earlier version. Your gems, shards and settings stay as they are, and you can return to the newer version the same way. The kept copy is made at update time, so the first rollback works from the update after this one.
• Any background colour. The background swatch row has a "custom…" dot that opens the macOS colour wheel. Every window follows the pick live.
• Terminal font size is in settings, under the terminal font, 10 to 24 pt. Cmd + and Cmd − still work.
• Terminal text colour. A colour well in settings sets the colour of plain terminal text, so dark text on a light background works. Programs that colour their own output keep their colours.
• The agents table column for wrapper commands is now called HARNESS, and the page says when to leave it blank.

2.274.0

November 6, 2026

• A Claude wrapper such as claude-router now works as your claude command. Mark it with crystl agent profile set --agent 'ccr code' --as claude, or in the new "behaves like" field in settings → agents → agents, and crystl starts, resumes and prompts it like Claude.
• A hero's or shard's first prompt reaches a wrapper command as one quoted argument, so quotes and dollar signs in the task no longer break at the shell.
• "Turns left" can be right for a custom model: crystl model context set <model-id> <tokens> tells crystl the model's real context window. The context-window field on a model endpoint now counts too.

2.273.0

November 6, 2026

• Every notification card now has a three-dot menu. Turn off that kind of card for every gem in one click, with undo, or jump to notification settings.
• Approval cards get the same menu with "Auto-approve everything in this gem", which answers the call and switches the gem, with undo.
• Cards have more room inside: wider insets and a little more height.
• Agents now add what they find along the way to the workbench without being asked: bugs they did not fix, work they skipped, questions they left open. An empty workbench says so.
• The test suite is green again on the weekly CI runner, and its cap is raised so the held-out suites get their turn.

2.272.0

November 5, 2026

• Adding a Claude or Codex account now tells you what happens next. The new login shard opens in front of you, and a card and the shard's first lines say how to sign in and where to rename the account.
• "+ add account" in settings → agents → agents takes you straight to the new login shard, and the accounts list has room to breathe: each button sits on its own row.
• An orchestrator shard shows a castle icon beside its name instead of the word, and the account name on a shard's bottom line underlines when you point at it.

2.271.0

November 5, 2026

• Claude Code and Codex can each run on more than one login. Add an account in settings → agents, or with crystl agent account add, then type claude@work in any shard to use it. The line at the bottom of each shard shows which account it runs on, and clicking the name lets you rename it or add another.
• crystl now shows how much of your Claude and Codex plan limits you have used, and when each limit resets: on each shard's bottom line, at the foot of the agent activity panel, and with crystl usage. A worker stopped by a limit says when it can run again.
• The add agent form in settings → agents → agents takes typing again.

2.270.0

November 3, 2026

• A new servers tab in the agent activity panel. It lists every dev server listening on this Mac, grouped by gem, with how long each has run and which shard owns it, or orphan when nothing started from crystl is holding it any more. Servers left running for more than a day show their age in orange, and each row has a stop button.
• The servers tab says so when two servers share a port, one on IPv4 and one on IPv6, which is how localhost can end up serving the wrong site.
• Agents read the same list with crystl servers, and can stop a server with crystl servers stop. Both are free on every tier. An agent's own process is never listed and never stopped.

2.269.0

November 1, 2026

• crystl notify now reads its body from stdin or --message-file. A worker's notes reach its lead as written, where before only the one-line default was sent.
• A new shard opened after crystl had been running for three days or more now gets your zsh config and crystl's shell integration again. macOS cleans old temp files, and crystl's startup files were among them; crystl now puts them back before each shard starts.
• The Mac's bridge token now works only on the Mac itself. A copy taken off the Mac does nothing.
• Each phone keeps its own credential. Phones already paired keep working, and there is nothing to do.
• Each new QR or copied token mints a fresh credential, which lapses after 10 minutes if nobody uses it.
• Uninstalling crystl removes the phone credentials along with the token.
• An SSH shard's hooks carry their own credential. After a crystl restart, open a new shard and run ssh from there; the refusal says so.
• Guild phone users away from home now go through a sealed relay. The relay carries encrypted traffic it cannot read.
• When a new device asks to pair with a code a shell could have made, a card appears on the Mac and only your click lets it in. A phone QR or a code you clicked for in crystl's own window asks nothing.
• The card appears even with notifications switched off, and a device asks at most once a minute.
• Settings → mobile says plainly why the relay is off.
• A phone connected over the relay keeps working after the Mac restarts crystl. Before, its next action could fail until the phone reconnected.
• The remote terminal repaints only the rows that changed, so an echoed character no longer costs a full-screen redraw.
• The remote workspace skips the repaint when a poll brings no terminal change.
• The crystl.dev libraries are free on every tier: templates, heroes, skills, prompts, facets, agent blocks and questlines. Questline import and sync are free too.
• Parties imported from a repo count toward the free party limit. Held-back parties show as a quiet row in the quest party picker, and the upgrade prompt says what was refused.
• Creating a project-local hero needs Guild. Editing, renaming and deleting an existing one stay free.
• The needs-a-person list shows the shard that started waiting most recently first, on the desktop activity panel and on the phone.
• The rail's top and bottom edge fades are drawn the right way up and clear once a resize settles.
• The facet bar's path label is easier to read.
• Going back to an older build after this one makes phones pair again.

2.268.0

October 28, 2026

• Project links. Each gem keeps a named, grouped list of the places it keeps going back to: the live site, dashboards, staging, the design file. Each link can carry a note. They live in a plain LINKS.md in the project, under the links tab in the workbench drawer. Click a link to open it, drag to reorder, and collapse a group you are not using.
• Your agents use the same list with crystl links, so they can look up a URL there instead of asking you, and add one when they find it.
• Adding or editing a link uses a proper form, with a labelled field for the name, the URL, a note and the group, and save and cancel buttons.
• The shard you select is always the shard you see. On a busy Mac, a click could leave another shard's terminal showing under the selected tab. Split panes also come back the way you left them.
• When several agents ask to change the same notification switch, you get one card instead of one per agent.

2.267.0

October 27, 2026

• Notifications are six plain switches. Settings → agents → defaults now has notifications (the master switch), needs you, agent finished, tool activity, messages to you, and other terminals. Each one says what it covers. Your phone follows the same switches, and your old choices carry over.
• Turning off needs you hands approvals and questions back to the agent's own terminal prompt, so nothing waits on a card you will never see. goose keeps its approval cards, because it has no prompt of its own to fall back on.
• An agent can no longer turn off notifications or needs you by itself. It asks instead: you get a card with the change on it, and nothing happens until you click.
• Sequences can be resumed and stopped. A run that parks because a stage is blocked has a resume button: fix what blocked it, and the stage runs again. Stop ends a run and keeps the shards and checkouts of its unfinished stages. Both are in the sequences drawer and the CLI (crystl sequence stop and resume).
• Merging or rebasing a worktree that a running sequence owns is refused, with the run's name, so a run's branch is never rewritten underneath it.
• A scheduled, polled or file-triggered run that is refused always gets a card.
• The optimizer's report actions are buttons now. launch optimization agent opens a new shard with your default agent already working through the findings, and copy for agent says where it saved the report.
• Turning off tell agents about the crystl CLI also removes crystl's section from your global agent instructions, and the setting explains what that costs.
• crystl tidies its record of old shard sessions, so the first shard you open in a gem starts faster.
• The phone connection forwards only the routes the phone app uses.

2.266.0

October 26, 2026

• Tell your agents about yourself. Settings → identity is a short description of you: your name or handle, what you do, and how you like to work. A portrait and stats are optional. Every agent you run in crystl can read it, so you stop explaining yourself at the start of each session. It is stored only on this Mac, in ~/.crystl/identity.md, and crystl never uploads it. An agent you run may send it to its model provider. New installs are asked once at first launch, and upgraders see one card about it.
• Your character card moved from heroes to Settings → identity.
• Agents can read and update your identity with crystl identity show, update and edit. All three are free on every tier.
• Quests now know you by your identity. Heroes see your name and address, your messages are routed by it, and a hero that shares your name can no longer claim your messages.
• The terminal underlines a link only when a click on it opens something. A path to a file that is not there stays plain.
• A bare domain like crystl.dev shows as a link, and a click asks first: visit https://crystl.dev, copy it with https://, or copy it as written. On a remote shard you can also open it as a file.
• crystl no longer hides an uncommitted CLAUDE.md, AGENTS.md or .claude folder from git. Repos affected by earlier versions are repaired when you open them.
• An agent's crystl message can carry backticks or $( ) that the shell would run. crystl now stops that message and tells the agent how to send it safely. Turn it off under Settings → agents → defaults → prose guard.
• crystl optimize finishes on large repos in a few seconds, and --json reports errors as JSON.
• The project optimizer's north star check clears once each section has real text and a rejection is recorded.
• Starter kits skip a file when one with a similar name already does the job, like VOICE-GUIDE.md or docs/superpowers/specs. A project folder inside a bigger repo uses that repo's workbench.
• crystl keys scan finds Shopify tokens and Google OAuth client secrets, and skips dependency and build folders before it counts files.
• crystl keys note saves a note that only looks like a key, such as a Stripe account ID, and adds a warning. It refuses only values in a known secret format.
• Shard shells no longer hold on to crystl's own open files, which could leave a git check waiting at launch.
• Closing a shard at the moment its shell exits is now safe.
• A sequence with a file trigger starts watching the moment you publish it.
• A message you send while the agent is mid-turn now shows where you sent it. The end of a long message no longer shows up as the agent's reply.
• The phone app calls its conversation mode "composer", to match the desktop.

2.265.3

October 25, 2026

• Typing claude by hand while macOS is still asking for Keychain access now waits for your model endpoint's key. It waits up to 20 seconds. If the key is not ready by then, crystl says why and shows how to start it anyway. Other commands you type pick up the key as soon as it arrives.
• Removing a model endpoint whose agent profile cannot be changed keeps the endpoint and names the profile and the reason, in settings and in crystl endpoint remove. Removing it again retries.
• crystl endpoint list keeps each endpoint's last key save across a restart. A save that was still waiting when crystl quit shows as interrupted.
• Bridge responses carry the correct HTTP status text, including "Accepted" for a key save that is waiting for Keychain approval.

2.265.2

October 25, 2026

• Saving keys never holds up crystl. API keys and model endpoint keys now save in the background, so a Keychain prompt left open no longer pauses the app. A save counts as done only once the Keychain confirms it.
• The endpoint list shows each endpoint's last key save: waiting for Keychain approval, saved, or refused.
• crystl endpoint set returns after a few seconds while a Keychain prompt is waiting, and the key saves once you answer the prompt.
• "Reset relay identity" now finishes in a bounded time, and the relay secret stays on this Mac instead of syncing through iCloud.
• Keys saved by older versions move to the current store only after the Keychain confirms the save, and keep working while they wait.
• Screen readers now announce new notification cards.
• The window opacity slider now applies to every glass panel.

2.265.1

October 24, 2026

• crystl stays responsive while a Keychain dialog is open. Closing a shard, finishing a sequence stage and saving history no longer wait on the macOS Keychain, so a password prompt from any app, left unanswered, no longer pauses crystl.
• Saved history, command history and timeline rows are always masked against your stored keys. If crystl has not been able to read your keys yet, those writes wait in the background until it can, instead of being written early.
• Quitting writes every history save still in progress, and logs any it could not finish.
• Reading or saving keys on the API keys page keeps working when you choose "Allow" rather than "Always Allow".
• A Keychain read that has not answered yet is no longer reported as a missing key.
• Open notification cards no longer show a location line when the card has no location.

2.265.0

October 24, 2026

• Sending to a shard is now refused while you have pressed Up or Tab to bring back a line, so an automated send no longer lands on the end of a recalled command.
• Arrow keys in apps that use application-cursor mode no longer count as typed text, so leaving a menu with Escape no longer holds up sends.
• Vigil now notices a remote agent that has exited, from the remote shell's own prompt, and tells you instead of nudging an empty shell.
• A tool call that fails or is interrupted now counts as finished, so one worker no longer keeps a whole fan-out looking busy. Existing installs pick up the new hook automatically.
• The "your agent did not start" warning now appears for a freshly created shard whose launch never starts.
• Agents on a keyed model endpoint get the real key at launch, every time.
• A typed and then deleted emoji or accent no longer blocks sends for two minutes.
• A finished shard no longer flips back to working when a late idle notification arrives.
• Storage settings stay usable if you leave the page while a compact is running.
• The fallback xterm surface keeps drawing after the Mac wakes from sleep.
• A cleaner status line, a flat divider rail for the action bar and sidebar footer, and an underline on the active view mode, plus polish across the facet bar, the turns pill, the view-mode switcher, quest hover and shard-tab spacing.
• The docs now call the chat input the message box, and the view modes and keyboard shortcuts pages match the new design.

2.264.0

October 24, 2026

• Opening a shard is instant again. crystl was rewriting its whole session store on every shard start, so the pause grew with how much you had used it — on a well-worn install it reached a few seconds each time.
• A shard that has finished now says so. One that had reported done could keep reading "working" in the roster indefinitely, which left a fan-out looking busy long after it was over.
• Notification cards name the shard they came from again, so two cards from the same fan-out are no longer identical.
• The project optimizer recognises a folder written with its slash: art/ names art the way it used to.
• Copy stops clipping as it grows — in the key-request card, the connect and notification panels, and the pairing panel, whose buttons also sat slightly off the bottom edge.
• Bug reports and key notes hide two more shapes of secret: a value written as a YAML block, and a literal left sitting after a command substitution.
• Shard rows ask git fewer questions, and ask them off the main thread, so the window keeps drawing while they are answered.

2.263.0

October 23, 2026

• crystl stays fast with a crowd of shards open. Listing your projects no longer holds up every other request, so commands, approvals and the workbench answer in milliseconds even while a dozen agents poll the bridge at once.
• Startup stops waiting on the keychain. crystl now reads your stored keys once, in the background, and remembers a denial — so launch never hangs on a keychain dialog, and a fresh install asks for access once instead of over and over.
• Closing a shard tells the truth about uncommitted work. Build output and your agent's own runtime files no longer count as your work, and a worktree the close warned about always stays on disk — in both the terminal and the desktop dialog, whose keep button now says "keep changes" and means it.
• Key masking recognises more real-world spellings — Ruby and Makefile assignments, indented YAML, credentials passed as plain arguments — and stops refusing ordinary notes that mention 1Password, Vault or AWS references.
• Tests that only failed on a busy machine now wait for the thing they check instead of a stopwatch, so a red test run means something again.

2.262.1

October 23, 2026

• the key-note and key-request redaction pass now runs in linear time however dense the input. a pasted log or env dump full of password= pairs used to make the pass walk the whole line once per pair — long enough input could hold up the app. the same inputs now redact in under 50 milliseconds, and a card's reason is bounded before the pass ever sees it.
• "Not now" on a key-request card now answers just the shards that were waiting on it. asking again later — any shard — raises a fresh card instead of being silently declined for the rest of the session. declining twice is your call to make, not the app's to remember.

2.262.0

October 23, 2026

• your agent can now write down where a key lives. crystl keys note STRIPE_KEY --at apps/web/.env.local records a path, an owner, a standing fact, or a dated observation — so the next agent reads a note instead of re-searching the project. notes show up under their key's row in crystl keys and crystl keys where.
• notes hold names, paths and prose, never a value. anything that looks like it might carry a credential — connection strings in any dialect, password= pairs in any spelling, JSON and YAML forms — is masked whole on every reading surface and labeled for what it is ([redacted connection string]), and the clearly credential-shaped ones are refused outright with advice on what to write instead. a dated observation is marked stale after thirty days, because "this key was blocked" is only true the day it was seen.
• when a key is nowhere to be found, crystl keys request RESEND_API_KEY --reason "…" raises a masked card on your Mac. you type the value, it goes straight to the Keychain, and the agent is told only stored or declined — it never sees the value. the typing stays on the desktop: your phone gets an announcement naming the key, with no field and no button.
• one card per key name, naming every shard that asked. a second asker joins the existing card instead of raising another, saving once answers all of them, and "Not now" quiets that name for the rest of the app session. a card never outlives its askers — close the last asking shard and the card goes with it.
• the optimizer now reports key names a project mentions that nothing on the machine holds — and counts a name as covered when one of the project's own env files assigns it. advisory only; it never changes the score.
• the files tab draws your folders and files immediately. badges and analysis results fill in when the scan lands, instead of holding the whole tree behind it.
• .env parsing accepts < and > placeholders (KEY=<your-key-here>), so example files read correctly.

2.261.0

October 22, 2026

• crystl keys lists the key names a project knows about and whether your agent can reach each one; crystl keys where RESEND_API_KEY answers for a single name. the point is the report you have probably had: an agent says it does not have access to a key that was sitting in .env.local the whole time. agents are now told to check before saying it, so that answer should get rarer.
• three answers, and each says what to do next. reachable means it is already set in that shell, or crystl holds it and a new shard will start with it set, or one of the project's own .env files assigns it — and then it names the file to read it from. could-not-check means macOS has not let this build read your saved keys, and your agent is told to ask you to allow it once rather than to tell you the key is missing. not-registered is the only answer that means your agent really cannot get at it.
• neither command ever prints a key, in plain output or --json. a name, a status, and the file that mentions it.
• when crystl cannot read a project's env file all the way through, it says which file and whether asking again would help. a quote it cannot resolve gives the same answer every time, so it tells your agent to open that file instead of retrying forever.
• it says only what it actually read. the answer covers the .env and .env.* files at the top of a project, so a monorepo's apps/web/.env.local or an .envrc is named as somewhere still to look rather than quietly counted as checked.
• both commands are read-only and free on every tier. which keys a shard can see is still your choice — these tell your agent what it can already reach, they do not narrow it.
• a shard's status notifications now replace each other instead of piling up. when a shard asks a new question, the notification for its old one goes away — on the desktop, in the bell, and on your phone — because there is only one question you can actually answer. messages written for you (cards, schedule results, worker reports) stay until you dismiss them.
• request-copy lines no longer show up as agent messages in the chat dock.

2.260.0

October 21, 2026

• the shard line under the terminal is one line now, in the shard's own colour and the terminal's own typeface: amber · claude · opus · opened 3d ago · idle 4h · 3 commits not on main · ~71 turns left. no boxes, and the colour is what tells you which shard it is about.
• the turns readout moved into the end of that line and is the underlined part, so there is one place to look instead of a pill in the corner. clicking it still opens the context breakdown.
• a shard waiting to relaunch its agent on dispatch no longer says "its agent is gone". a lazily restored shard comes back as a bare shell on purpose, and the line was reading that as a dead agent and offering to close the shard.
• in chat mode that line no longer touches the message box. it lines up with the input and leaves space above itself.
• agents running inside crystl are told about the three answers 2.259.0 added — crystl shards --closed, the "still in a worktree" and "not pushed" lists, and crystl workbench list --on <day> — so they can reach for them without being told each time.
• crystl shards declares all three routes it reads, rather than one. nothing about what it is allowed to do changed; the catalog the tier page and the docs are built from was understating it.

2.259.0

October 21, 2026

• shards now say how old they are and where their work has got to. under the terminal there's a small band, outlined in the shard's own colour, reading something like amber · claude · opus · ⎇ crystl/amber · opened 3d ago · idle 4h · 3 commits not on main. it describes the shard you have selected, and the colour is which shard it means.
• come back to a shard you left on an earlier day and the same band says what is in the way — "last touched Oct 6 · its agent is gone" — with the action beside it. it clears when you type. a shard that is old but clean and merged says nothing, which is most of them.
• that idle time now survives restarting crystl. it used to count from the moment the app came back, so a shard untouched for a month read as "idle 14s" and the stale notice could never fire at all.
• crystl shards --all answers "is anything unfinished anywhere" in one call: a still in a worktree list of every shard across every gem holding work that hasn't reached the integration branch, and a not pushed list of gems whose integration branch has commits that never left the machine. branches with no shard are in there too — the ones left behind when you closed a shard.
• both lists say how many gems they could actually ask, so a closed gem is named as unasked rather than quietly counted as fine.
• crystl shards --closed brings back the shards a gem no longer has, grouped by the day they were last active, with how long each lived, its turn and command counts, and what happened to its branch. the last 30 days by default; --since all for everything.
• crystl workbench list --on today (or a date) answers which tasks actually moved that day, from the edit history the workbench has been keeping all along.
• markdown and mermaid render by default when you open a .md file, with view and edit modes.
• remote images in a markdown preview no longer load on open. each one becomes a placeholder naming the host, with a button to load it — so previewing someone else's README doesn't tell that host you opened it.
• the agent activity panel has an unmerged column, so one window answers the same question for every gem.
• crystl shards --closed went from 81 seconds to 3 on a gem with 273 remembered shards.
• the gem sidebar remembers which view you had open, per gem.
• answering a question on the phone no longer leaves the card's queue position reading "1 of 1" when it wasn't.
• the shell-startup warning ("this shell took longer than 15s") no longer appears on shards that are working perfectly. it waits until it can tell whether the agent actually started, says which agent and what was lost, and takes itself back if the agent turns up late.
• the ahead and behind counts on a shard's pill are measured in that shard's own repository. a shard whose worktree lives outside its gem's folder could previously be shown another branch's state.
• "not pushed" counts refresh after you push, in every gem rather than only the one you're looking at.
• a branch count that couldn't be measured says so instead of showing 0, which read as "nothing to merge".
• a shard that only ever ran shell commands is listed in the closed-shard history instead of being missing from it.
• the word "landed" is gone: a shard says merged to main Oct 20, or merged to main when the date isn't knowable, rather than a word you had to already know.

2.258.0

October 19, 2026

• answering a permission on your phone no longer brings back a second card about the question you just answered. two separate things announce a prompt — the hook that draws the card, and a read of the terminal screen — and the screen stays stale until the agent repaints. both now know the question was answered.
• the same stale screen no longer sends a "waiting for input" push a few seconds after you have already said yes.
• a card's action button now runs the command on the card, rather than whatever the device asked for. it was already the same command in practice; now it cannot be anything else.
• scheduling a command, and writing files inside a gem, now need the terminal-control grant you give a device at pairing time. a device paired only to read and send is back to exactly that.
• the agent activity panel's tab hint reads as a hint instead of a fourth tab, sits out of the way on the right, and names both keys: ⇥ / ⇧⇥ switch tabs.
• smaller type in the file editor panel, matching the rest of the app.

2.256.0

October 15, 2026

• Keyboard for the sidebar. Cmd+] and Cmd+[ cycle the right sidebar's views (workbench, files, markdown, and sequences when enabled) — a first press opens a closed drawer, and the arrow buttons' tooltips show the keys. In the agent activity panel, a small hint beside the tabs now points out that Tab and Shift+Tab switch them.\
• Starter kits for every agent. The kits tab lists every agent's starter kits, not only Claude's, and each kit says which agents it serves.\
• crystl recognizes Kiro and Muse Code. AWS's Kiro and Meta's new Muse Code show up under their own names in rosters and transcripts, and the files drawer credits Muse Code's reach on AGENTS.md and the shared .agents/skills/ folder.\
• Clicking a tab while a withdrawn question card is still fading out now lands instead of doing nothing.
  \

2.255.0\

October 15, 2026
\

• Agent skills, for every agent. The files drawer now understands the open SKILL.md standard (agentskills.io): skills are recognized wherever they live in your project, each one shows which of your agents can discover it from there, and launch-cost estimates charge only the small metadata part agents actually load eagerly.\
• One skills folder for all your tools. crystl suggests .agents/skills/, the shared home read by Claude Code's peers (Codex, Cursor, Gemini CLI, Copilot, Goose, and other tools adopting the standard), with a ? bubble explaining why it is worth having. A "new skill…" entry in the + file menu scaffolds a spec-valid skill, and one click links the folder into Claude Code's own discovery path for the one major tool that reads only its own folder.\
• The skills wiring is careful by design: it only ever runs from your own click, never overwrites a real file or folder, and plainly says "could not reach this gem" instead of guessing when a remote connection drops.
  \

2.254.0\

October 14, 2026
\

• The files drawer gets easier to read and navigate. Folders draw in the brand blue with files in white, a breadcrumb in the drawer's header says where you are as you scroll deeper (crystl › docs › archive), and the navigation arrows beside the drawer's title are bigger.\
• Suggestions now explain themselves. The tree offers the recommended instruction files (GEMINI.md, CLAUDE.local.md, .cursorrules) and the docs/ and .claude/ folders as dotted rows, each with a one-click add button and a ? bubble saying what the file is for and why it helps: instructions kept in the repo work for agents from every vendor, travel with the code, and stay easy to read and edit.\
• Approval and question cards withdraw themselves when you return to the shard that asked, so you can answer in the terminal without a stale card lingering on top.\
• The drawer remembers which files tab you use per gem, and an explicit Optimize action jumps to the optimizer tab without rewriting that memory.\
• The "+ file" menu now offers your saved library files alongside a new blank one, so a saved AGENTS.md is one click to reuse in any project.\
• In the agent activity panel, Tab and Shift+Tab move between the agents, orchestration, and touches tabs.
  \

2.253.0\

October 14, 2026
\

• The new files drawer. Every gem's sidebar now has a files tab. Browse the project's file tree, see which files your agents actually read, and create new files in place. It replaces the old optimizer window.\
• An agent reading map for every project. File rows show how your agent reaches each file (instructions, imports, or location), and a read-order view estimates the tokens each file costs at launch. A file crystl cannot read says "cannot tell" instead of staying silent, and remote gems are covered too.\
• The optimizer now lives in the same drawer as its own tab, opening with a prominent score card, then the score detail and findings with clearer action buttons, plus a plain note on what the score leaves out.\
• crystl optimize --show opens the files drawer, and Optimize actions land directly on the optimizer tab.\
• Sidebar navigation got simpler: back and forward arrows flank the tool name, cycling files, optimizer, workbench, and markdown.\
• crystl doctor --full reports retained scrollback and live agent sessions, and memory telemetry now reports the app's real physical footprint.\
• An agent crystl does not recognize keeps its own name in neutral grey instead of borrowing Claude's color or transcript.\
• The keyboard stays on the terminal when the sidebar drawer changes mode.
  \

2.252.0\

October 12, 2026
\

• ~/.codex/config.toml, the .claude/settings.json family and .mcp.json are written through a symlink now, so a config you keep in a dotfiles repo stays one file. That includes the Codex trust grant, which writes when crystl starts.\
• WORKBENCH.md as well, so a backlog two gems share by link stays shared.\
• Removing the last crystl entry from a linked config clears it through the link, so the file you keep is the file that changes.\
• A config crystl cannot read is left alone, rather than rebuilt from what it managed to parse.\
• Where a link points at a file that is not there, crystl says the link is broken and leaves it as it is, instead of replacing it with an ordinary file. New gem presets, starter kits, kit installs and skill imports all behave this way now.\
• Archiving will not overwrite your archive when it cannot read it first.\
• With two gems whose paths share a prefix — ~/Projects/app and ~/Projects/app-web — a shard in one was counted against the other. One shared rule now decides which gem a directory belongs to, so a parent gem and a gem inside it no longer depend on which was opened first.\
• The project optimizer's explore tab opens .claude, .codex, .cursor, .agents and .github, where your agent's files actually live, and no longer walks down into node_modules.\
• Adding a file from that tab goes through the same installer as everywhere else, so it tells you what it wrote and what it skipped.\
• A skill import that cannot write says so, instead of showing the row as added.
  \

2.251.0\

October 12, 2026
\

• 2.250.0 kept a symlinked CLAUDE.md through the CLI section's install. The same care now covers every other place crystl writes one of these files: the file library's replace, the markdown editor, the simple editor, rules and SKILL.md saves, NORTH-STAR.md, the instructions import, Codex skill imports, and the /fanout command refresh that runs at launch.\
• The launch one is worth naming on its own. If you keep ~/.claude/commands in a dotfiles repo by symlink, that link stays a link.\
• Where two names share one file without a link between them, crystl says so on screen rather than only in the log — the write separates them, and that is yours to decide about.\
• The replace warning no longer calls a hard-linked overwrite unrecoverable. The other name still holds your old text.\
• Adding a starter kit to a gem goes through the same installer as crystl bundle install: it writes only what is missing, never replaces a file you already wrote, and reports what it wrote and what it skipped. That button used to write in silence, including when the write did not happen.\
• A skill import that cannot write says so and stays clickable, instead of settling into "added" over a skill you do not have.\
• The simple editor says a save failed when it failed.\
• The agents-file check knows every name that file goes by, so it stops reporting a connection you already have.\
• A gem crystl cannot reach now reads as unreachable, rather than as a project with no files in it.\
• crystl's own managed section round-trips a block-mode save byte for byte, so editing your instructions in block mode leaves that section exactly as it was.
  \

2.250.0\

October 12, 2026
\

• A new project type for a brand and the marketing run from it. Content is a project — drafts in, pieces out, and it can finish. A brand is a home base that does not, so it gets its own checks.\
• Project optimizer asks a brand gem for nine things: what the brand stands for, how it sounds, the sites and accounts that carry it with the property ids to query them, who it is up against, where the assets are, what is running, what the numbers did, why the brand changed, and who it is for.\
• The starter kit writes all of it, including a properties file that asks for account ids and handles and says plainly that keys belong in your keychain, not in the repo.\
• Set it with crystl gem type set brand-marketing, or pick it in the New Gem panel and gem settings.\
• The gem's agent is a selector now, listing every command that can be picked, rather than a field to type a name into.\
• An agent you picked but have not saved survives the panel rebuilding underneath you.\
• The row says DEFAULT, because a gem is not bound to one agent — it is the starting point for new shards.\
• A symlinked CLAUDE.md stays a symlink. crystl follows the link and writes the one file both names read, including ~/.claude/CLAUDE.md pointed at a dotfiles repo. Previously the write turned the link into an ordinary file: nothing was lost and both names still held your text, but they stopped being the same file and drifted apart from then on.\
• Uninstalling the CLI section follows the same link, so it is removed from the file you actually keep instead of stranded there.\
• Where two names share one file without a link between them, crystl says so on the install report rather than only in the log — the write separates them, and that is yours to decide about.\
• Project optimizer no longer reports "AGENTS.md is not connected to CLAUDE.md" when the two names are already one file, and no longer offers a fix that would have imported a file into itself.\
• On a remote gem, where crystl cannot check whether two names are one file, it says that instead of offering a fix it cannot stand behind.\
• A file answers one question. brand-assets/ is the assets area and no longer also counts as the brand file, so a gem holding one directory stops reading as if it held both.\
• A word describing a document's form no longer outvotes its subject: voice-guidelines.md is the voice file, and campaign-log.md is the campaigns record.\
• The same applies to writing projects, where published-drafts used to satisfy both the drafts and published checks at once.\
• Every suggestion names a starter kit that exists. Several used to point at "the starter bundle", which is not something you can install.
  \

2.249.0\

October 10, 2026
\

• A hero's picture belongs to the hero now, not to its name. Renaming a hero keeps its picture, deleting one takes its picture with it, and two heroes with similar names no longer share a file.\
• Setting a picture for one hero can no longer change another hero's, including the built-in heroes.\
• A hero's picture also shows on its quest-party cards, which previously drew the Crystl logo for project-local heroes.\
• Renaming a hero onto a name another hero already uses is refused instead of replacing that hero.\
• A click on a path with no file behind it says what it found: whether the folder is there and the file is not, or nothing along the path exists. It used to do nothing at all, which looked like a broken link.\
• Only paths crystl marked as links explain themselves, so clicking an ordinary word stays quiet.
  \

2.248.0\

October 8, 2026
\

• A hero you invented can have a picture you choose. Click the portrait in the hero editor, or drop an image onto it. Every custom hero used to show the crystl logo, because an invented name has no portrait on crystl.dev.\
• The picture is stored when you save the hero, so picking one and then changing your mind costs nothing — cancel and nothing is kept.\
• A hero copied from a built-in keeps showing the original's picture until you give it one of its own. Setting one no longer changes the hero it was copied from.\
• Renaming a hero keeps its picture. Deleting a hero deletes its picture too, so a later hero with the same name starts fresh.\
• A picture you set for a built-in hero is yours to set, and it shows everywhere that hero appears.\
• A click on a path with no file behind it now says what it found, instead of doing nothing. If the folder is there, it names the folder and says the name may be wrong, the file may be gone, or a symlink may be broken. If nothing along the path exists, it says so and names both places it looked.\
• This is the /tmp screenshot case: a path stays clickable after the file has been swept, and a click that quietly did nothing looked like a broken feature.\
• Only paths crystl actually marked as links explain themselves, so clicking an ordinary word in prose stays silent.\
• The answer reaches you in a worker's shard too, where it used to be held back with that worker's routine progress.
  \

2.247.0\

October 7, 2026
\

• The speaker's name is the same size as what they said. It was smaller than the message, which read as a demotion of whoever was talking.\
• Your own name is the app's blue everywhere now. It used to take the colour of the shard you were in, so "you" changed colour from one shard to the next.\
• Agent names are lowercase, like "you" beside them — two speakers in one conversation, written the same way.\
• The copy button on a tool-output block no longer touches the top edge of the block.\
• The note in the shard reads as plain sentences and tells you what actually helps. It used to suggest sending the shard a message, which types into the shell rather than reaching an agent.\
• A shard whose agent never started now says so in crystl shards, not only to crystl wait blocked. It reads "no agent — its shell never came up", which names the cause rather than restating that nothing is running.\
• A shard waiting on something unrecoverable says "summon it again" rather than "respawn".
  \

2.246.0\

October 7, 2026
\

• When crystl holds a message for a shard — because something is half-typed on its input line, or an earlier message is sitting there unsent — the card that tells you now has a clear the line button. Pressing it releases the held message. It also says what you gain and what you lose, since clearing discards whatever was typed there.\
• The card stays up until you deal with it rather than folding away, and it shows even while you are looking at that shard.\
• crystl dispatch cancel --gem <gem> --shard <shard> discards what is being held, for the case where the message should no longer arrive at all. It prints what it dropped and shows you the same text on a card, so a cancel aimed at the wrong shard can be retyped. To deliver what is held instead of dropping it, clear that shard's input line.\
• A shard whose shell takes too long to start has its agent launched anyway, and that launch can land in a shell that is not reading yet — so the agent never starts and any opening prompt goes with it. Until now the only sign was one line inside that shard. It now reports as "no agent — launch did not start" in crystl shards, wakes crystl wait blocked, and reaches your phone.\
• The note in the shard itself leads with the usual cause, a busy machine, says the agent may not have started, and tells you that sending to the shard launches it again.\
• It stays quiet about shards that are fine: a plain terminal with no agent, an agent crystl cannot recognise, and remote shards.
  \

2.245.0\

October 7, 2026
\

• Chat uses the font you picked in settings → appearance, at its own reading size, so the conversation and the terminal agree about what your session looks like. What you type in the composer is in that typeface too.\
• Bullet lists, quotes and code blocks get the same line spacing as ordinary prose, so a message that mixes them reads evenly.\
• Headings, code and rules are in that same typeface. Clicking a message to select text keeps it that way instead of flattening everything to one size.\
• Easier on the eyes against dark glass: softer body text, a little letter tracking, and real line spacing on ordinary prose rather than only on lists and code.\
• Headings are heavier rather than larger, so a ## and inline bold agree about what emphasis looks like.\
• Fullscreen chat is the terminal's size again.\
• A wrapped bullet line starts under its own text at any font size.\
• Backticked paths and links no longer pick up a grey highlight. Code is told apart by tint and a one-point size step.\
• crystl abort now clears a shard's input line as well as stopping its turn. If a worker had stopped accepting input — sends reporting bytes with nothing arriving, then "unsubmitted interactive input" on every attempt — an abort gets it going again instead of leaving you to start a fresh shard. Thanks to the person who reported this twice with the sequence that found it.\
• crystl send --no-enter says "Typed … not submitted" rather than "Sent", because it stages text on the input line without pressing Enter, and that staged line is what holds up the next send.\
• Turns left is accurate after a compaction, where it used to read about a third high, and it keeps its estimate on the turn the compaction lands on.\
• A shard's model is resolved once and read everywhere that shows one: the turns pill, the agent roster, the quest and side-quest life bars, the hero card and the bridge. A shard on opus, on a model endpoint, or on a GLM model behind an Anthropic-compatible endpoint is labelled as itself.\
• An agent that names no model of its own (a custom binary, aider, opencode, goose, kimi) no longer borrows Claude's.\
• A quest member keeps its model across a restart. An ordinary shard still says nothing until its first turn reports one, because a relaunched agent can resolve a different model.\
• Restored shards count their full history: a turn whose token snapshot arrived on a tool call is no longer dropped, and a token panel opened on a freshly restored shard fills in instead of sitting at zeros.\
• The welcome tour's context-window step names the real threshold: the estimate starts after two turns, not three.
  \

2.244.0\

October 6, 2026
\

• Two messages sent one after another arrive as two messages. If the first was still sitting unsent on the input line, the second no longer lands on top of it.\
• A message your agent never received is no longer shown as sent. It stays in the list, and the next thing you type cannot clear it away.\
• A message whose text changed on the way into a shard no longer leaves a second copy of itself behind.\
• Closing a shard or quitting with a message still waiting now tells you, naming the shard and quoting your own words back. On quit the warning arrives while cancel is still a button.\
• A shard renamed while a message was waiting is called the same thing everywhere that reports it.\
• A message waiting behind something you are part-way through typing says so after twenty seconds instead of two minutes.\
• A message sent to a shard from a panel — a nudge to a worker, a quest broadcast, a questmaster reply, a crown briefing — waits for the input line instead of joining whatever was already on it. Facet buttons still land on the line you are looking at, which is the point of them.\
• Messages your agents send each other no longer merge with a line left over from an earlier one.\
• An isolated shard's pill shows how many commits it is behind as well as how many it is ahead.
  \

2.243.0\

October 5, 2026
\

• A shard restored from a saved session no longer gets stuck when its agent relaunch does not run. It gets another attempt on your next dispatch or visit, and if a send is refused meanwhile it now tells you the shard is a bare shell waiting to be woken rather than a worker that went quiet.\
• A restored shard remembers which agent it was running. Before, a Claude shard you had started yourself could come back with its agent forgotten, and the next save wrote that gap down as permanent.\
• Chat opens on a shard with no agent, as it already did on the phone, and says what is going on: there is no agent yet, the composer is how you start one, and anything you send meanwhile runs in the shell.\
• The chat header no longer sits on top of the first lines of your conversation, and the conversation starts closer to the tabs instead of below a band of empty space.\
• Text now softens as it scrolls past the top of a conversation rather than cutting mid-letter.\
• The terminal peek moved from a button in the chat header to Cmd+Shift+Y. It is the lighter sibling of Cmd+Y: that one changes the window's mode and stays changed, this one borrows the terminal for a look and leaves the mode alone.\
• Popping a command block out into its own window wraps long output to the window instead of running off the side, keeps tables scrollable so their columns stay under their headers, and can scroll all the way to the end of tall output.\
• Your phone takes a card's notification away when you deal with the card on your Mac, even if the phone missed the moment it happened. A notification whose card is simply older than the phone can account for is now kept rather than cleared.\
• The phone's blocked banner no longer shows a mark that looks like a close button but is not one.\
• You can summon a hero when creating a shard from your phone.\
• The project optimizer counts one instruction file once, however many spellings of its name exist, and its CONTEXT column shows context or nothing at all.\
• The agent activity panel redraws a row only when something about it actually changed.
  \

2.242.0\

October 4, 2026
\

• Deal with a card on your Mac and its notification now leaves your phone too, even if the phone was asleep at the time. A card still standing on your desktop keeps its notification, including one waiting on an answer or a button.\
• The phone's shard list shows the model on its own, so a Claude shard reads "claude-opus-5" rather than repeating the agent name. The agent and model now sit beside the shard name instead of three lines below it.\
• Agent activity panel: the title clears the window buttons, the agent and context columns line up with the headers above them in the "needs a person" list, and each agent's status line has a little more room. Status marks are drawn in the same icon set as the rest of the app.\
• Project optimizer: a finding's detail wraps to as many lines as it needs instead of stopping at one, and the project-type note reads to the end of its sentence. The header shows one gem icon.\
• The optimizer's direction-file finding now says what a north-star file is for, and how it differs from a rules file like AGENTS.md.\
• "create north star" sends the whole prompt to your agent. If the prompt is too long for the shard's terminal to take in one line, crystl says so and puts it on the clipboard rather than sending part of it.\
• Icons across settings, the workbench and the file pickers draw at the softness they were meant to, so they sit with the text beside them instead of standing out from it.\
• The agent activity panel skips redrawing a row when nothing about it has changed.
  \

2.240.0\

October 3, 2026
\

• Follow your workers from the roster. Open a lead's Progress view to see workers across projects, expand their threads, and clear unread replies. A manual Nudge button lets you prompt a worker when needed.\
• Restored shards retain their last reported turn state, making completed work and requests for input easier to spot after reopening Crystl.\
• Agents that spawn ordinary workers automatically become leads, so worker progress stays connected to the agent that assigned it.\
• Project-list changes are pushed to connected companions immediately. Roster updates preserve each connection's permissions and cannot be overwritten by an older pending refresh.\
• Agent waits for approvals and questions now default to their own project. Updated guidance clarifies when an idle worker still needs attention.\
• Added update-target diagnostics to help investigate reports of needing several consecutive updates.
  \

2.239.0\

October 3, 2026
\

• The chat composer now finishes what you type. Start a facet or a crystl command and the rest appears in grey after the cursor; Tab or the right arrow takes it, Return still sends your message.\
• Talk to your agent hands-free from the chat dock, and pick which microphone it listens to.\
• The phone's inbox is now an agent activity overview, so what needs you is the first thing you see.\
• Choose and reorder the shortcuts in the phone's tab bar.\
• Rename a shard from the phone's gems list.\
• A message you send while your agent is mid-turn stays visible until the agent accounts for it, on the desktop and the phone alike, including messages sent from the CLI or another shard.\
• Chat no longer loses a conversation that was still loading when you kept typing, and an empty conversation no longer reads as an unread one.\
• Codex keeps its own shard's identity, so conversation capture and restart resume no longer land in the wrong shard, and codex agents and codex remote-control still reach the shared daemon.\
• Tapping an approval notification on the phone now takes you to the approval rather than wherever you were headed.\
• A shard waiting to relaunch no longer hides a shard that is genuinely waiting on you.\
• The phone polls your gems far less often.
  \

2.238.0\

October 3, 2026
\

• Fullscreen chat now uses the full shard area, follows your terminal font size, and reclaims space when the facet strip is empty.\
• Chat controls stay clickable at the bottom edge and follow window resizing and changes to the copy bar and other bottom bars.\
• Answers already selected in a multi-question prompt survive chat resizing and font-size changes.\
• Restored agent sessions resume without an extra continuation prompt. If the agent refuses the resume, crystl retries once with the saved prompt, only after the shell is ready; typing into the shard cancels the retry.\
• The welcome tour now explains the terminal, split, and chat view controls. Roster column headers have more breathing room.
  \

2.237.0\

October 3, 2026
\

• A request that arrives while crystl is still launching now answers "not ready\
• A settings change that could not be written says so, and names the file.\
• A wait that received a report it could not read says that, instead of\
• A sequence follow that loses the bridge says so rather than repeating the\
• A gauntlet or court profile that cannot be found refuses before launching\
• The dev server chip appears on a roster that is already open, and goes away\
• The error badge on a gem tile clears when you look at the row, not when you\
• crystl shards --all groups and ranks the same way the panel does.
  \

2.236.0\

October 2, 2026
\

• Chat has two views: simple shows just the conversation — tool calls fold into tap-to-open markers, and tables always stay visible — while detailed shows every tool call inline. Flip between them with the control in the chat header.\
• Chat now follows your agent at wire speed: new turns and tool calls appear within a blink of the agent producing them, and message bubbles no longer pick up terminal line-wrap artifacts.\
• The typing indicator now stops the moment the agent finishes its turn.\
• Chat explains itself when there is nothing to show: agents whose conversations crystl can't read get a plain sentence instead of an empty pane, and when the terminal is waiting on a dialog, chat says so instead of showing typing dots.\
• Flipping chat views keeps your place: at the bottom you stay at the bottom, and reading history you stay where you are.\
• Jev reads turn endings more accurately after a round of tuning.
  \

2.235.0\

October 1, 2026
\

• crystl can read who needs you, not just who is quiet. Turn on Jev (a\
• A finished shard tidies up after itself. Closing a shard now removes its\
• Your phone chat catches up. A message sent while an agent was mid-turn no\
• Agents learn the CLI as they use it. When a command has a better\
• Your roster stays focused.crystl wait and crystl events from a shard\
• Monthly billing is smoother. Switching plans on the same day reactivates
  \

2.234.0\

October 1, 2026
\

• Agents on the free tier now say "here's what I can do instead." When a\
• The CLI teaches a better next move as agents work. When an agent copies\
• A lead's listeners hear its own fleet.crystl wait and crystl events\
• A second copy of crystl bows out instead of disturbing your session. If\
• Workbench stays scannable.crystl workbench add gently points agents at
  \

2.233.0\

September 30, 2026
\

• Four more agents now show approval cards. opencode, goose, kimi and GitHub\
• Your shard roster says who is waiting for you. An idle shard used to read\
• An approval card no longer hides behind a busy terminal. If a shard was\
• Your licence stays valid through the whole of its last day, so a monthly\
• Removing crystl now removes every agent hook it installed. An agent added
  \

2.232.0\

September 29, 2026
\

• The project optimizer can now fix what it finds. A finding with a mechanical fix has a button: crystl appends the missing .gitignore line itself, or makes @AGENTS.md the first line of your CLAUDE.md so Claude Code actually reads the instructions you wrote. Everything else it can describe precisely, it can hand to an agent in a shard: a loop in your instruction imports, files past your own size limit, a settings.json that will not parse, missing permission rules, and credentials sitting in files git would commit. A dispatched prompt opens by saying crystl sent it, and carries only what the optimizer measured, so an agent never acts on advice crystl invented. The two credential prompts carry the file and the line and never a key value.\
• Two projects' scores mean the same thing now. A check your project's type rules out no longer lowers the highest score you can reach, so every kind of project tops out at 100 and a 70 is a 70 whatever you are building. A check crystl could not measure is still counted against you, because not knowing is not the same as passing, and it is capped so that not knowing never costs more than the worst real answer would have.\
• Five new things the optimizer looks for, each only where it applies. Whether your instructions say which files are generated and what to edit instead, since an agent that edits a generated file appears to succeed and loses the work on the next build. Whether they say how to run one test rather than the whole suite. Whether they carry everything in one file that is loaded at the start of every session, instead of pointing outward to the detail. Whether directories like node_modules are actually ignored by git, since an agent can spend its whole context reading them. And whether a monorepo's sub-applications have anything for an agent to read. A project that already answers one of these never hears about it.\
• Findings read in full. A long finding was cut off mid-sentence, and one with commas in it was rewritten to end "and 2 more", counting things that were not there. Around twenty findings were affected.\
• Code projects are now asked where designs and procedures go, and any project is asked where documents go at all, alongside the existing per-type questions. Starter kits gained the matching sections.\
• A gem with no instructions file now reports the number of checks its type ruled out, instead of a count that disagreed with the rest of the report.\
• An untyped project is told once that picking its type scopes the checks to what it actually is.\
• Fixed a scheduled shard staying in crystl's books after you closed it by hand, which could warn about overlapping runs a firing early.
  \

2.231.0\

September 29, 2026
\

• A schedule can now rotate through a list of prompts, sending a different one each time it fires. It suits a week of different reviews: security on Monday, dependencies on Tuesday, dead code on Wednesday, and so on round the list. That is one schedule instead of five, and you edit the whole week in one place. The desktop form has a "rotate through a list" toggle with add, remove, and reorder, and the detail view numbers the list and marks which entry fires next. Rotation works for commands as well as prompts, and the phone shows the entry that runs next.\
• A schedule can also run a plain shell command, with no agent at all. Pick "command (no agent)" in the schedule form, or crystl schedule add --gem <g> --at "..." --command "<shell>". If the task is already written down, like bash scripts/backup.sh, there is nothing for a model to decide, and the run no longer arrives in your token ledger as agent work. Command runs report how they went: succeeded, failed with the exit code, or ran somewhere crystl could not watch. A failed run raises a card naming the command that actually ran, and keeps its shard so you can read the scrollback.\
• A scheduled command's shard is now kept open whenever its command may still be running, and closed only once crystl has seen it finish. A backup that runs for nine hours, or one that started a helper in the background, stays alive through later firings of the same schedule.\
• A scheduled command that crystl could not watch start now says so, instead of reporting that the command never ran. A shell without crystl's shell integration looks exactly like this while the command runs fine.\
• Scheduling is on the free plan, up to 3 schedules, agent or command. A rotating schedule counts as one however many prompts it holds.\
• On the phone, a tool call in the chat collapses to a single line with a button to open it, so a long run stays readable.
  \

2.230.0\

September 28, 2026
\

• Fixed crystl send silently dropping a long message. A single line over 1023 characters sent to a shard sitting at a shell or cat was discarded by the terminal while crystl reported it delivered — so an agent could act on half an instruction. It now refuses the send and tells you why. Agent sessions were never affected.\
• Fixed remote SSH sessions never recording token usage: crystl was looking for the transcript on the wrong machine.\
• Fixed the project optimizer reporting live files as missing — a command like bash scripts/build.sh was read as a file path, and references written as a partial path didn't resolve.\
• History search now says which agents it couldn't read and where their conversations live, instead of answering "no matches" as though none existed.\
• The context pill no longer promises turn counts for agents that don't report them.\
• Faster crystl merge and crystl close on projects with committed agent config.
  \

2.229.3\

September 28, 2026
\

• Fixed a freeze: a stale, unrelated macOS Keychain prompt (from another app) could block the whole window until you answered it, because periodic session-history autosave was waiting on the same Keychain queue.
  \

2.229.2\

September 27, 2026
\

• Internal cleanup: consistent naming across notification, approval, question, and denial cards. No behavior change.\
• Refreshed the bundled hero catalog.
  \

2.229.1\

September 27, 2026
\

• Fixed a worktree merge that could wrongly refuse over a permanently gitignored file.\
• Fixed several false positives in the project optimizer, including a gitignore check that missed directory-level rules and stale-path warnings that misfired on cross-repo references.\
• Project optimizer: moved the "save" button below the type picker instead of above it, and confirmed the save with a small toast.\
• Added a hint when the scrollback cap has trimmed earlier output.\
• Capped the tool-output preview to 2 lines instead of letting long wrapped lines fill the screen.
  \

2.229.0\

September 27, 2026
\

• Notification cards with an action button now run that action right from your phone.\
• Moved the hands-free button into the key row.\
• Cmd+A now selects all terminal text.\
• Fixed a worktree merge that could wrongly refuse over Crystl's own config files.
  \

2.228.0\

September 26, 2026
\

• Added a detail view for tool calls on the phone, matching the desktop pop-out.\
• Fixed right-to-left text (Arabic, Hebrew) selecting, clicking links, and displaying numbers on the wrong characters.\
• Fixed right-to-left table cells swapping content with their neighbor.\
• Fixed a workbench bug where two people commenting on the same task at the same time could silently lose one comment.
  \

2.227.0\

September 26, 2026
\

• Fixed selecting text in a Codex shard rendering as an invisible white-on-white block.\
• Fixed the "retry" button on a denied tool request — it now actually lets the agent try again instead of doing nothing.\
• Fixed pop-out windows for chat tool output not wrapping text.\
• Chat tool results on the phone are bounded by default now, with a way to see the full output.
  \

2.226.0\

September 22, 2026
\

• Fixed the project optimizer window not resizing — the panes now follow when you drag an edge.\
• Fixed a race where a workbench task's done checkmark could silently revert if it was checked off while the sidebar was out of sync.
  \

2.225.0\

September 22, 2026
\

• Card action buttons now stay on screen until you click them or dismiss the card, instead of folding away on a timer.\
• Fixed the action button's caption sitting over the wrong button.\
• crystl send to a shard with no agent now delivers the text cleanly instead of breaking the shell.
  \

2.224.0\

September 21, 2026
\

• New panel: agents can attach a one-click action button to a crystl card, so instead of describing a fix they can hand you a button that runs it.\
• "Click to expand" now opens in its own window instead of pushing the chat dock around.\
• Fixed a few click-to-open bugs, and clickable paths in the terminal now show in blue with an underline so you can see what's clickable before you hover.\
• Notification cards are quieter about repeating what's already on your screen, without dropping the ones meant just for you.
  \

2.223.0\

September 21, 2026
\

• Fixed a rendering glitch where a divider line could cut through a gem icon when moving the rail between the side and top of the screen.
  \

2.222.0\

September 20, 2026
\

• Crystl rail shrinks when you don't need it, expands when you do.\
• Fixed a timing bug that kept some notifications from collapsing into the notifications bar.\
• Added more detail to collapsed notifications when you reveal them.
  \

2.220.0\

September 19, 2026
\

• The "this looks like a new project" setup offer no longer shows up on projects you've had for a while — it only appears right after you create a gem.\
• Adding a comment to a workbench task now confirms which task it landed on, instead of printing the whole board.
  \

2.219.0\

September 18, 2026
\

• Shard close (and Close All) no longer warns "N commits not yet merged" for a branch that's already merged to main. Fixed for local gems and SSH-remote gems.\
• Agent-team chat messages now show who actually sent them, instead of appearing as if you typed them.\
• The PROJECT TYPE "?" help is now a proper crystl-styled popover instead of a system alert, with tightened-up copy.\
• The New Gem panel no longer mentions NORTH-STAR.md before you've created the project.\
• crystl workbench comment now tells you which task it landed on, instead of printing the whole board.
  \

2.218.0\

September 18, 2026
\

• Every gem can now say what kind of project it is. A PROJECT TYPE picker — Code, Research, Content, Records, Personal, Orchestration, or General — lives in the New Gem panel, gem settings, and the optimizer. The choice is saved as one line in NORTH-STAR.md, and it tells the project optimizer what to suggest if you run it. Agents can read and set it too: crystl gem type.\
• NORTH-STAR.md is the new direction file: what a project is for, who it serves, and what you have said no to. crystl never writes one on its own — crystl northstar init (or the optimizer's create north star button) hands your agent a drafting conversation that reads the repo first and asks you to correct it, and crystl northstar reject "<why>" records a no the moment you make one. Projects that keep this material in a spec-kit constitution.md are read there instead of being asked for a second file.\
• Starter kits for every kind of project, not just code: Research, Content, Records, Personal, and Orchestration kits each ship the files their kind of work needs, and every kit includes a WORKBENCH.md and a MISTAKES.md. The built-in code offering is now one universal kit — the stack-flavored kits live in the online catalog for whoever wants them. crystl bundle list shows what your gem's type is offered; crystl bundle install <kit> installs it, says exactly what it wrote and what it skipped, and never overwrites a file already doing the job under another name.\
• The optimizer tells you whose work each finding is. Every finding is marked structure (a starter kit can supply it) or substance (only you can write it), the summary says both — "3 structure gaps — 2 things only you can fill in" — and a finding fixable by a command prints it as a fix: line.\
• Optimizer scores are honest about what was measured. A typed gem skips the checks that don't apply to its kind of work, the report says how many were skipped in that run and the top score the type can reach, and a check that could not run scores as unknown — never as passed.\
• A brand-new gem offers to set itself up. One dismissible line above the terminal — *this looks like a new project — set it up?* — starts your agent with the optimizer's findings in hand. It fixes what the repo can answer and asks about the rest; dismiss it once and it never returns.\
• The optimizer window got polish: the gem name at the top is now a switcher for scoring another open gem without closing the panel, and the layout breathes properly.\
• New gem and open gem moved into the sidebar footer as one two-sided button, and the New Gem panel opens above it. Open uses the same full folder browser everywhere it appears.\
• File editors no longer open a file they could not read. A remote file that fails to load over a flaky connection used to appear as an empty editor; now the panel says the content did not load, and a save can never write over content crystl never read. The optimizer's create buttons follow the same rule before scaffolding.\
• Remote gems write only on their own machine. Setting a type or recording a rejection on an SSH gem whose connection has dropped refuses with a clear message instead of touching the wrong disk.\
• Full screen no longer shows a black bar across the top of the window.\
• Uninstalling is a button now: settings → general → uninstall crystl… removes the agent hooks, helper script, and CLI command, tells you exactly what it did, and then offers to move the app to the trash for you. crystl doctor also recognizes hooks left behind by an old uninstall and offers to repair them, and the hook script itself stays silent and free when the app is gone.\
• The Help menu links straight to getting started on crystl.dev, and new docs pages cover the direction file, gem types, starter kits, hooks, and troubleshooting.
  \

2.217.0\

September 17, 2026
\

• crystl now masks api keys and tokens in its own stores. Two stores held them as readable text: the timeline history database that crystl history search reads, and the scrollback logs crystl saves per project. Both mask credentials as they are written, and the copies already on your machine are swept once, automatically, on the next launch.\
• A masked row keeps everything else — the full command or turn, its timestamps, its place in history — and the mask is itself searchable, so a search for the key still finds the row it was in.\
• Remote shards upload their saved scrollback to the ssh host. That copy is masked before it is sent, so the file on the host matches the one on your mac.\
• The key matcher no longer mistakes ordinary text for a credential. A command like git checkout sk-refactor-the-terminal-core stays readable in your history, while real keys in short base64url and vendor-labelled shapes are now caught.\
• A gem set to "in gem" approves your agent's work inside the project. It no longer approves writes to the files that decide what gets approved. Writes to .crystl/ and to your agent's own config — hooks, permissions, skills, .mcp.json — raise an approval panel like anything else. You can still approve them and the write happens as before. Unattended sequence stages follow the same rule.\
• Shell integration survives a customised zsh setup. If you relocate your zsh config with ZDOTDIR, or run with setopt nounset, crystl's integration used to drop out silently — no command history, no working-directory reporting, no tmux identity, no completion — and every shard start waited out a 15-second timeout. Your config is sourced from wherever you put it, and the integration runs alongside it. Shells you start inside a shard get it too, including when your own rc file sets ZDOTDIR again.\
• The welcome tour introduces the right-edge drawer properly: it names all three panels — workbench, markdown and sequences — and how the button beside the title cycles between them. It also says what the "+" makes, which is an isolated shard in its own git worktree, or a hero with the persona and model you give it.\
• Tour cards point at the controls they describe. The gem-settings step names the gesture that works — right-click a gem in the crystal rail — and uses the menu's own words.\
• The panel is called the workbench everywhere. Five leftover strings still said "backlog", a word that appears nowhere in the interface.
  \

2.216.0\

September 17, 2026
\

• Heroes launch the agent you configured. Your small, standard, and large commands now outrank whatever agent happens to be running in the gem, so a hero starts the command you set instead of the one a neighbouring shard was using.\
• Opening a shard in a gem that already has one keeps your configured standard command. Before, crystl treated any agent it found nearby as the decision and set your command aside.\
• Sequence hero stages read the same configured commands. A stage that needs a fallback agent now picks up the small, standard, or large command from settings → agents → defaults.\
• A new isolated shard always starts on a fresh branch. Crystal names come back around, so a new worker could be handed a name whose old crystl/<name> branch was still on disk and start from that old tip. Now the name goes to a fresh branch instead.\
• Restoring a saved formation reattaches the branches it saved. Parked isolated shards come back with their work on them, however long the arrangement sat.\
• Remote isolated shards over SSH take the next free name on the host. crystl asks the host which crystals it already holds and picks a name past them, so the isolated-shard button works on a remote gem without you choosing a name yourself.\
• A remote isolated shard that cannot be created says why. The reason is written into a shard you can still read, and you keep a working shell in it.\
• A remote create that stalls is bounded. If the host stops answering, crystl gives up after a deadline and leaves you a shell with the reason in it rather than a tab that never comes alive.\
• Storage settings can clear sequence run records. The page shows what the store costs in total and per gem, you choose the scope, and the confirmation says exactly what goes. A run that is still going stays.\
• The recent-runs list drops a project you deleted and keeps one that is merely on an unmounted volume. A drive that comes back brings its history whole.\
• A sequence stage's declared capabilities reach its agent whole. The capability list you wrote in your own file goes into the stage prompt as written, without being narrowed against the sequence beside it.
  \

2.215.0\

September 17, 2026
\

• crystl shards --all answers "who needs a person" across every open gem in one call. It leads with the shards waiting on you — parked on a dialog, sitting on an unanswered question, out of credentials, out of quota — and each row names its gem, its shard and what to do about it. When nobody is waiting it says so in one line.\
• Every shard roster now says what an idle shard's last turn actually was: asked a question (quoted on the row), declared done, reported back, or failed. Before, a shard that finished and a shard that asked you something both showed the same idle time. This works for claude, codex and antigravity, and an unanswered question is still there after you restart crystl.\
• The Sequences drawer keeps the last twenty runs of each gem, on disk. A run that failed stays on the list instead of disappearing, and the list is still there after a restart, so you can see whether your runs have been failing lately.\
• Sequence stages launch your agent with the tools and commands it normally has. A stage that needs to run a script can run it, and the stage still has its own way to report its outcome. When you author a sandbox in the sequence yourself, crystl honours it exactly as you wrote it.\
• Resizing a terminal window is calmer. Your agent sees one size change when you let go of the edge rather than every width you drag through, so it repaints once. Tables keep their frames across narrow and wide, and growing a pane by height shows the revealed scrollback straight away.\
• The copy bar gives the terminal its rows back cleanly when you dismiss it, and it takes a little less height from the terminal while it is open.\
• Two gems opened on the same folder each keep their own name, icon and colour. Renaming one no longer overwrites the other, and an icon you clear stays cleared instead of coming back on the next reload. Remote gems follow the same rule.\
• The path browser can go up past your home folder all the way to the root of the disk, so network volumes are reachable by browsing instead of only by typing the path.\
• Chat dock text stays readable when you click a message on a Mac set to Light Mode. Arabic text in the dock renders with proper letter shaping and right-to-left order.\
• Hero cards name the agent that will actually start. A hero that pins nothing now reads "default · standard" and takes the command from its size, instead of claiming claude no matter what you had configured.\
• The hero editor fits a 13" laptop screen, save button included, and the agent hint no longer draws over the MODEL label.\
• Creating two shards in quick succession gives you two worktrees. Before, the second could land in the first one's worktree and commit to the wrong branch.\
• A remote session that fails while it is being created cleans itself up, so you are left with the gem you had rather than a half-made shard.\
• crystl installs its Claude Code hooks without touching the rest of your settings.json. Hooks you added yourself stay where they are, and a settings file crystl cannot read is left alone rather than replaced.\
• Duplicate-row cleanup during heavy output does less work, so a shard printing fast costs less CPU.\
• On the iPhone app, you can hold a whole spoken conversation without touching the phone: it listens, sends, waits, reads the reply aloud, and listens again. Speaking over the reply stops it mid-sentence. It decides you have finished talking from your words rather than from a fixed pause, so a breath mid-thought no longer cuts you off.\
• The iPhone app reads replies in the best voice your phone has, and a voice picker in settings speaks a sample when you tap one. Where only the flat built-in voices are installed it says so and shows you how to download a better one. "read replies aloud" is now the feature's on switch: turn it off and the speaker button goes away.\
• Remote shells over SSH keep your own zsh configuration, and the startup files crystl puts on the remote host stay bounded instead of growing with every launch. When crystl cannot set them up it tells you why and still gives you a working shell, and a background process you leave running no longer stops a later shell from starting.
  \

2.214.0\

September 15, 2026
\

• Workers you fan out are named for what you sent them to do, so a roster shows parser and tests instead of six gemstones.\
• crystl no longer says a fan-out collapsed when its lead is just working in another gem.\
• Agents can tell "I could not reach crystl" from "this message was forged". Restarting the app, or a fan-out big enough to slow it down, no longer makes one look like the other.\
• A background task that is still running after its shard closes can send and notify again.\
• Deus puts a ruler in a gem that does not have one, instead of running workers across gem boundaries.
  \

2.213.0\

September 15, 2026
\

• Agents can now check who really sent them a message. When one agent messages another, the delivered line carries a token the receiving agent redeems with crystl dispatch verify — it reports the source gem, shard and role, and text that merely imitates the format fails, because it carries no live token. Legitimate cross-project orchestration used to get refused as suspected prompt injection; now it can be confirmed instead of guessed at.\
• Dispatched messages say who they came from. The sender's name is tinted in the terminal and attributed in the chat dock, and a message that crosses projects names the project it came from, so an orchestrator's instruction reads differently from your own words.\
• Merging a worktree handles the awkward cases. An untracked file in the way, a branch whose history has already diverged, and paths with spaces in them are each recognised and reported rather than half-applied.\
• Summoning a hero into a remote project waits for the shell to be ready before reporting success, and clears up after itself if the remote worktree can't be made.\
• Scheduled sequence runs enforce the permissions they declare, and two more flags that would detach an agent from its approval channel are refused.\
• Sender names containing wide characters — CJK, emoji — highlight the right columns in the terminal.\
• iPhone app 1.0.26: messages from other agents arrive with their sender and hero identity intact, and photo uploads say when an image was downscaled.
  \

2.212.0\

September 14, 2026
\

• Heroes now keep durable shard names, restore reliably, and retain their distinct colors across sessions.\
• Local and remote hero-name races now fail closed, preventing two live shards from claiming the same identity.\
• Phone views now show the live hero and lead identity, including the intentionally combined isolation and special-status icons.
  \

2.211.0\

September 14, 2026
\

• Fixed heroes being disabled when their configured agent had valid size-specific models.\
• Crown and Hand now launch as two new shards instead of inserting commands into the active shard.\
• Deus now launches as a standing fleet-wide shard without inheriting a worker/lead relationship.\
• Removed the universal recommendation for agents to scan keys before every commit; key scanning remains available on demand.
  \

2.210.0\

September 14, 2026
\

• Conversations stay responsive: new assistant replies appear while their complete transcript is still loading.\
• Codex tool activity is clearer and more reliable. Failed nested commands now show as failures, and complex tool calls keep accurate context.\
• The Hero chooser now groups orchestration roles and pairs Crown with Hand for quicker setup.\
• The iPhone companion keeps active chats current and resumes visited shards more smoothly.
  \

2.208.0\

September 12, 2026
\

• Fixed a deadlock that could freeze Crystl when the mobile app connected while the desktop was reading shard status.\
• Deus now listens for live agent-status changes across gems, keeping its oversight current without repeated polling.
  \

2.206.1\

September 8, 2026
\

• A message typed to an agent from your phone could be run as a shell command when a relaunch looked healthy but had already failed. A relaunched agent now has to stay up before its restore counts as successful.\
• Quitting an agent left its shard refusing everything you sent it, for the rest of that shard's life. Worst on the phone, where the composer is the only way in. Input reaches the shard again.\
• Shell lines typed in the terminal tab came back as "you" chat messages on the next refresh and never cleared.\
• A failed relaunch could quote an ordinary echoed shell command back at you as though it were the agent's error.\
• The worktrees panel listed another project's live checkout as parked, where it could be discarded. The discard path now re-reads the live set before acting.\
• crystl send silently delivered only the tail of a long message to an agent. It now reports how many bytes were delivered, and crystl screen warns when more questions are queued behind the one on screen.\
• A sequence stage using a custom model endpoint launched without that endpoint, so it ran against the wrong model. The stage now carries its endpoint binding through to launch.
  \

2.206.0\

September 7, 2026
\

• The project optimizer scores what your project actually gives an agent. It reads instructions that arrive through an @AGENTS.md import or a symlink, follows that import even when it points at another file first, and says when nothing connects AGENTS.md to CLAUDE.md at all.\
• A broken link is named as a broken link, instead of being reported as a missing file.\
• A leaked credential in a file git would commit now affects the score, and those rows sort to the top of the list.\
• Suggestion buttons insert the block they name. They used to open the file and leave you to find it.\
• The score shows as a number beside the word, and gap details name the files they found instead of counting them.\
• Around a dozen checks that inferred a problem from an absence are gone, and .claude/settings.json now says when it will not parse — which used to leave every hook and permission rule in it silently doing nothing.\
• crystl optimize reads the shard's own project rather than whichever gem is selected on screen.\
• The update button stays beside the version number when the workbench drawer is open.
  \

2.205.1\

September 6, 2026
\

• Fixed a scrollback bug where a repeated sentence could get lost.
  \

2.205.0\

September 6, 2026
\

• Send a photo and what to say about it as one message from the phone. Pick the image, type your note, and both reach your agent together.\
• A question from your agent stays on screen until you answer it. Hiding a question card used to leave the shard turning messages away with no way left to reach the question.\
• A message typed alongside a photo is kept if the photo cannot go out yet. It returns to the composer instead of leaving with the picture.\
• The conversation no longer shows an already sent message as waiting each time you send a new one.\
• A message that never reached your agent is now marked unconfirmed, rather than looking like one that landed.\
• Parked worktree cleanup is more careful. It leaves a checkout alone when another crystl build has an agent working in it, and when it cannot tell, it says so instead of reporting nothing to clean up.\
• The worktree storage card counts what it would remove more accurately, and keeps its title on one line.\
• Opening a gem stays quick when an older sequence run cannot migrate its saved brief.\
• A sequence run that fails to start leaves a readable record, filed under the gem it belongs to.\
• A quest that runs past its deadline is reported as a timeout, not as a connection that failed.\
• A remote command that times out lets go of its pipes, so nothing is left waiting on them.
  \

2.204.0\

September 5, 2026
\

• Prevent duplicate phone-chat messages when delivery retries switch from LAN to relay.\
• Make notification panel resizing wait for the actual animation target, improving reliability during rapid updates.\
• Warn when parked worktrees use significant disk space and safely reclaim a bounded number of clean, merged, inactive worktrees.\
• Protect worktrees that are active, reattached, dirty, unmerged, externally created, or otherwise unsafe to remove.
  \

2.203.0\

September 4, 2026
\

• Quest launches now stay in the gem and shard you are viewing, including launches started through the CLI in another gem.\
• Quest startup and shutdown are now transactional: failed, cancelled, or remote launches clean up safely instead of leaving partial quest state or starting heroes after the quest ends.\
• Remote quests now keep their local status mirror current, preserve authored progress when continuing, and recover cleanly from interrupted publishing.\
• Restored gems remember the shard you last selected, and cross-gem notifications are delivered only to their intended shard.\
• Phone approval and question timestamps are accurate again, and larger terminal-screen refreshes are coalesced to avoid duplicate work.\
• Fixed a relay identity lock inversion that could stall background relay activity.\
• The CLI now rejects mistyped commands clearly while preserving crystl help …, and waits long enough for the complete remote quest-start transaction.
  \

2.202.2\

September 3, 2026
\

• Fixed a follow-up edge case in yesterday's isolated-shard fix: two differently-cased directories under the same parent could still be misidentified as the same directory in an unusual mount setup.
  \

2.202.1\

September 2, 2026
\

• Creating an isolated shard could fail outright when a gem's saved folder path used different letter casing than the one on disk. Isolated shards now create correctly in that case, and a failed create shows the real reason instead of a generic error.\
• A shard could occasionally hang while starting up if its shell took unusually long to become ready. Crystl now moves on after a short wait instead of getting stuck.
  \

2.202.0\

August 31, 2026
\

• crystl now fades up smoothly as it launches, all the way to its full glass look\
• your gems arrive one at a time in the sidebar as the window settles\
• the rail waits for the window to finish appearing, then slides in
  \

2.201.0\

August 30, 2026
\

• Claude Code works in fullscreen. Claude owns scrolling and search; crystl reads the live screen and keeps the timeline, chat dock and conversation search going from the transcript. Reads are accurate and quick now, including with htop, vim and less.\
• crystl commands --output returns the right command's output after a scrollback clear, and command numbering keeps counting.\
• crystl shard close says what it left behind, and names the right recovery for commits and for uncommitted changes. crystl merge exits nonzero when it refuses, so a script can tell.\
• A bridge that can't take its port says so, and crystl doctor names it.\
• crystl pending drops prompts from an agent you killed.\
• On the phone, a dropped connection to your Mac reads as a message, and the app backs off instead of retrying into it.\
• Settings → agents → claude lays out properly.\
• accept.equals catches malformed references where you write them. Closing a gem during a live run is safe.
  \

2.200.0\

August 29, 2026
\

• A failed run now names the budget that ran out — tokens 5000 of 1000 rather than just "budget exhausted" — and keeps the first one that crossed, so the reason can't change afterwards.\
• crystl sequence runs shows why a run stopped, instead of making you open the run to find out.\
• A stopped run keeps the shard and checkout your keep policy asked for. keep: on_fail is the default and exists for exactly this, so the terminal and the working copy are there when you go looking.\
• A run that stops leaves nothing running: stages and attempts read as finished, and the agent is stopped rather than left spending against a run that already ended.\
• Sequence definitions can be committed. .crystl/sequences/ is no longer ignored, so a definition travels with the repo and survives a fresh clone.\
• crystl sequence schema now describes what a trigger actually takes — the fields for schedule, file and poll, with their defaults and bounds. crystl sequence validate catches a malformed trigger where you write it, rather than at run time.\
• Failure text from an acceptance command can no longer disturb the terminal it prints into.\
• A poll's ignore pointers follow the JSON Pointer spec, including keys that are the empty string — previously a pointer like //stamp removed the wrong field.
  \

2.199.1\

August 28, 2026
\

• crystl vigil done now works for every fan-out, not only the first one in a session. Merge a batch, close the workers, and the command still retires the watch it was nudging you about.\
• Long conversations stay whole on the phone. A transcript that arrived in pieces no longer loses the earlier part of the conversation.\
• Tool calls read as what they do. A subagent shows the task it was given rather than repeating its own name, and tools with nothing to show read as a plain name in the dock, on the phone, and in crystl history.\
• Steadier terminals when shards close. Shutting down a busy shard no longer risks a hang or a crash while its output is still arriving.
  \

2.199.0\

August 28, 2026
\

• Quitting stops the agents crystl started. The confirmation now says so\
• Closing a shard shuts down its shell and anything backgrounded at its prompt,\
• If crystl is killed or crashes, the next launch tells you what was left\
• A stage whose accept command contains a quoted # now runs. It was being
  \

2.198.0\

August 27, 2026
\

• Crystl now checks for updates automatically and shows a small badge next to the version number at the bottom of the terminal when a new one is ready.\
• Auto-approval is more careful around a few edge cases — a plain git add . chained with another command, and writes into a repository's internal .git folder (including a linked worktree's or a submodule's), are no longer treated as automatically safe.\
• Fixed a rare case where a message sent to a shard right as it entered or left a full-screen tool (like a picker or menu) could be mishandled.\
• Fixed a sequence editor field where a long prompt could overlap the section below it instead of wrapping cleanly.
  \

2.197.0\

August 27, 2026
\

• A message sent to a shard whose screen is busy with a menu, picker or other full-screen tool is now held back with a reason instead of going nowhere. It works the same on every terminal surface — previously the check only ran on one of them.\
• The chat view refreshes far more cheaply: a poll that finds nothing new costs almost nothing, where before it rebuilt the whole conversation every time.\
• Conversations with Antigravity agents pick up new messages as soon as they arrive.\
• Auto-approval no longer treats git add . & <anything> as a safe git command, and no longer auto-approves writes into a repository's .git internals — including a linked worktree's or a submodule's.\
• A shard you renamed keeps its name when you resurrect it, and the resurrect menu shows that name alongside the crystal one.\
• The terminal renderer picker is gone from settings. Crystl uses its own renderer, and still falls back on its own if that renderer cannot start.\
• Agents can bring the sequences drawer into view when you ask them for a sequence.
  \

2.196.0\

August 27, 2026
\

• A message sent to a shard that is waiting on a question now comes back with a clear reason instead of quietly going nowhere. Answer the question in the inbox, in the terminal, or with crystl askuser answer, then send it.\
• Dismissing a question card in a conversation keeps the question in your inbox until you answer it.\
• The update badge lines up with the turns pill, and the version label uses the standard type.
  \

2.195.0\

August 26, 2026
\

• The status bar now shows which version you are running, and a badge appears beside it when an update is waiting. Tap the badge to take it.\
• A file-watch sequence tells you when its watched path is a pattern. Watched paths are literal — naming a directory covers every file under it — so notes/*.md is refused as you write it, instead of leaving the watch armed and quietly matching nothing.\
• Acceptance commands that can never fail are caught in more of the ways people write them: || /usr/bin/true, || (exit 0), || { true; }, sh -c "exit 0", and fallbacks like || echo skip or || cat /dev/null. A gate that cannot fail is a gate that is not there.\
• The fan-out quorum message reads "1 instance" rather than "1 instances".
  \

2.194.0\

August 26, 2026
\

• File-triggered sequences now fire right after you publish them, instead of waiting on the next background check.\
• Sequence runs pick back up correctly when you reopen a gem that had one in progress.\
• The default auto-approval setting is now labeled clearly in Settings (was "auto-approve").\
• More reliable phone chat replies when the terminal reply extractor is bounded to the composer's own region.\
• The question-card dismiss button on the phone no longer overlaps the card content.\
• Several smaller reliability fixes: launch no longer re-reads session/formation data unnecessarily, a stuck sequence run's lock state no longer gets stuck permanently once resolved, and the sequence runs listing correctly reports when it stopped short of every match.
  \

2.193.0\

August 26, 2026
\

• Closing a gem while one of its sequence runs was still going could take crystl down with it. The run's record now survives the close, and reopening the gem picks it back up.\
• Switching sequences off returns you to spending nothing on them. 2.192.0 marked a machine as having used sequences just for reading the setting, which left the storage checks running (including a probe on every worktree operation over SSH) even with the feature switched off. Upgrading repairs that mark.\
• Run times print in your local time rather than UTC.
  \

2.192.0\

August 26, 2026
\

• Sequences are on out of the box. The sidebar drawer's mode button now cycles workbench → markdown → sequences, and that third view is the catalog for the open gem: every definition, whether it validates, and the record of any run.\
• Sequences have a real switch. Settings → agents → schedules carries "sequences (early access)" — turning it on or off takes effect immediately, with no restart, and the triggers follow it in both directions.\
• Writing a sequence is free on every tier; running one is a Guild membership. A free member gets the catalog, the validator's verdict, and an explanation of what sequences do, with the upgrade offered where the run would go.\
• crystl status reports the version of the app that answered, so you can tell a running instance from an installed one.\
• When crystl sequence isn't available, the message now names what to check and where the switch lives instead of stopping at "unavailable".
  \

2.191.0\

August 26, 2026
\

• Sequences, as an early preview. A sequence is a fixed pipeline of agent stages, written down in a file and run the same way every time — each stage hands its output to the next. Start one by hand, or on a schedule, a file change, or a polled URL. crystl sequence list | validate | run | status, and a stage agent reports back with crystl stage complete | blocked | nothing. The definition format is still settling, so treat a sequence you write today as something you may need to adjust. Docs: crystl.dev/docs/sequences\
• Fanout workers can reach you again when they need to. Their routine progress stays quiet as before, but a worker that runs crystl card to ask you something, or that gets stuck on a rate limit or an expired login, now shows up on the desktop and the phone instead of waiting silently.\
• Approvals and notifications now follow the shard that sent them rather than its folder. A shared fanout worker sitting in a gem's root no longer quiets the notifications from your own shards in that same gem.\
• In-gem approval mode recognizes the multi-line commit form agents use, so ordinary commits no longer stop to ask.\
• Poll triggers keep their state across an update, and a source that fails in more than one way now backs off and eventually stands down rather than retrying forever.
  \

2.190.0\

August 25, 2026
\

• The Library is now context, and it lives with your agents in settings. It shows what an agent reads: your instruction files, your skills, your rules, your plugins, and the starter kits you can build them from.\
• Every tab says what is on this machine beside what is in the gem, with a picker naming which gem. A skill or rule that lives in your repository shows up next to the global one, where before only the global one did.\
• Each instruction file says which agent reads it — including that AGENTS.md is read by Codex, Antigravity and most other agents, but not by Claude Code unless your CLAUDE.md imports it.\
• Your own CLAUDE.md is in there too, both the one for every gem on this machine and the one in the gem you are looking at.\
• Duplicate a starter kit or an instruction file to get a copy that is yours, and rename it from the row's ⋯ menu. Built-ins open read-only, so you can read one without changing it.\
• Adding a kit to a gem writes the file that gem's agent reads, and says afterwards what it wrote and what it left alone.\
• Antigravity has a seat of its own. Kits and editor tabs target AGENTS.md, and an existing GEMINI.md keeps working exactly as it did.\
• A kit's rules reach Codex projects. They are written into the agent file rather than left behind.\
• crystl no longer writes a .claudeignore into new projects, and no longer asks you to add one. Claude Code does not read it — permissions.deny in .claude/settings.json is the setting that works.\
• crystl stays where you are. An agent that shows you a file or opens the workbench acts on the gem you are looking at, and will not move you to a different gem or shard while you are working.\
• Deleting a skill asks first, and acts on the machine the skill is actually on.\
• Vigil says which fan-out a nudge belongs to, so a fresh nudge budget reads as a new fan-out rather than a count that keeps resetting.\
• The save button in the hero editor is on screen for every hero, however much the editor holds.
  \

2.189.0\

August 25, 2026
\

• The Library shows what crystl ships beside what you have made. Duplicate a starter kit or an instruction file to get a copy that is yours, rename it from the row's ⋯ menu, and open a built-in any time to read it without changing it.\
• Every instruction file in the Library says which agent reads it — including that AGENTS.md is read by Codex, Antigravity and most other agents, but not by Claude Code unless your CLAUDE.md imports it.\
• Starter kits from crystl.dev load when you open the Library, so there is a catalog to duplicate from.\
• Antigravity has a seat of its own. Kits and editor tabs target AGENTS.md, and an existing GEMINI.md keeps working exactly as it did.\
• A kit's rules now reach Codex projects. They are written into the agent file rather than left behind.\
• crystl stays where you are. An agent that shows you a file or opens the workbench acts on the gem you are looking at, and will not move you to a different gem or shard while you are working.\
• The save button in the hero editor is on screen for every hero, however much the editor holds.\
• Settings → library → starter kits opens reliably.
  \

2.188.0\

August 23, 2026
\

• Vigil watches your fan-outs now, out of the box. When a manager and every worker it spawned go quiet at once, crystl nudges the manager and tells you if that doesn't move it — no setup required. Turn it off or tune how many nudges it sends before carding you in Settings → Agents → defaults.\
• The Library is its own settings page. Global and project-level rules, skills, and plugins now live under one Library section instead of being scattered — each one says what scope it's in, and plugins get their own tab instead of being counted in with everything else.\
• Key scan is a real settings page. Review the patterns crystl checks before a commit, switch any of them off, and teach it a key format your team uses that isn't on the built-in list.\
• "add to gem" is a real picker. Adding a file to a project now shows every open gem to choose from, and asks before overwriting one that already has it.
  \

2.187.0\

August 23, 2026
\

• Auto-approve is off · in gem · all. The same three behaviours, renamed for what they actually do — "in gem" means the agent reads anything, changes only files inside that gem, runs git that can't lose work, and asks before anything else. Your existing settings carry over untouched, and both the old and new spellings work on the command line.\
• A gem's approval mode is now a ceiling. A permission mode declared inside a project — an agent file's frontmatter, for instance — can narrow what gets auto-approved, but can no longer widen it. A file in your repo can't grant an agent more than you did.\
• Groundwork for the phone. The conversation syncs incrementally rather than re-sending the whole transcript, which cuts the data a phone uses while watching an agent work by about 95%.
  \

2.186.1\

August 20, 2026
\

• Terminal text holds together when something scales it. A window that overlaps a display of a different scale gets re-rendered at that scale for screenshots, screen recording, sharing and mirroring, and moving a window between displays does the same for a moment. crystl now blends the terminal surface through those, instead of sampling it a point at a time and dropping rows out of the letters.
  \

2.185.1\

August 19, 2026
\

• The workbench drawer opens cleanly on a full board. Sliding it out could leave the terminal drawing its text over itself for a moment, on gems with plenty of tasks; the board is now ready before the drawer starts moving, so the terminal is left alone while it does.
  \

2.185.0\

August 19, 2026
\

• A shard that cannot run now says so. crystl tells you what is in the way: out of quota, a credential only a person can fix, or no agent left. It reads the same in crystl status, crystl shards, on the shard row and tooltip, and on your phone, where these all used to read "idle".\
• Each kind carries what to do about it: wait until the retry time, go and unblock it, fetch a human, or respawn it. A rate-limited worker shows when it comes back, when its screen said when.\
• crystl wait blocked blocks until a worker is blocked, so an orchestrator can stop polling. Narrow it with --class input|time|credential|dead to wait for one kind. A worker already blocked when you start waiting is reported straight away.\
• A monthly spend limit reads as a credential block rather than a wait. Nothing about it lifts on a clock, so backing off would park a worker until somebody noticed by hand.\
• A rate-limited shard no longer reads as stale, and a quest hero blocked on a credential no longer gets nudged through the night. The quest master hears what is actually in the way instead of "stuck".\
• Your phone shows the block on the shard row and what it can answer, so an approval still stands out behind a quota wait.\
• Switching gems is quick again on a big workbench. crystl used to read and parse the gem's WORKBENCH.md on the main thread on every switch, which is what made a large board pause the window. Opening the drawer no longer waits on that parse either.\
• Workbench edits hold when an agent writes the board at the same moment. A tick or an edit made while crystl was re-reading the file could be dropped and then written back over.\
• The terminal keeps its shape when the workbench drawer opens. It briefly drew text over itself while the grid caught up with the narrower pane.\
• On your phone, opening a notification takes you to the shard it came from.
  \

2.184.0\

August 18, 2026
\

• Endpoints created with crystl endpoint set are now callable by name and change nothing else, matching how the settings form has always behaved. Pass --enable when you want one to be the ambient default for plain claude, codex, aider, opencode or goose. Endpoints you already configured keep the setting they have.\
• crystl endpoint list marks which endpoints are ambient defaults, and crystl endpoint set says so when a call leaves one that way, with the command to turn it off.\
• Enabling an Anthropic-format endpoint that runs on your own machine now tells you what that means for plain claude: it uses that endpoint's key, and only the models that endpoint serves.\
• The settings toggle's own description now names the same thing, so the choice reads the same from either place.
  \

2.183.0\

August 18, 2026
\

• open models are now agents you can type. an endpoint called glm gives you claude@glm — type it in any shard and Claude Code runs on that model, while plain claude keeps running hosted Claude in the same shard. add --size small to pick which of the endpoint's models you get\
• adding an endpoint fills in its callable agent for you, so a new provider is ready to use as soon as you save it\
• crystl endpoint list, set and remove put the whole providers & keys form in the terminal, so your agent can look up which API format a provider speaks and set it up for you. free on every plan, and keys are read from stdin rather than the command line\
• the endpoint panel is two columns now: what the endpoint is on the left, what it runs on the right\
• agents installed in your home directory launch correctly in worker shards again — an nvm or npx shim, a mise or asdf wrapper, or a plain alias in your shell config is now kept and used instead of being replaced\
• an ssh or tmux alias no longer stops a new shard from starting its work\
• crystl shard close <name> and crystl shard rename <name> take the name directly, crystl docs search "…" works, and crystl copy keeps working from a shell whose gem has since closed
  \

2.182.3\

August 16, 2026
\

• fixes the last launch crash from this weekend's packaging bug — the /fanout provisioner now loads its template the same safe way as everything else\
• if crystl still won't open, download this version fresh from crystl.dev/download/latest; from here on updates apply normally again
  \

2.182.2\

August 16, 2026
\

• fixes a remaining launch crash on Macs restoring an existing session — the terminal renderer now loads its resources from inside the app, like everything else since 2.182.1\
• releases are now smoke-tested as packaged apps before they ship, so this class of crash gets caught on the build machine
  \

2.182.1\

August 16, 2026
\

• fixes a launch crash that affected fresh installs and updates of the last few versions on some Macs — resources now load from inside the app itself\
• everything from 2.182.0 rides along: tap-to-talk dictation on the Mac, card pushes to your phone, dismiss-all that clears the phone inbox too, and sturdier bridge errors
  \

2.182.0\

August 16, 2026
\

• tap-to-talk dictation comes to the Mac: a mic button in the chat composer turns speech into draft text, and anything you type mid-dictation stays put\
• crystl card notifications now reach your phone as push banners, and schedules gain a phone-reminder option\
• dismiss-all on the desktop now clears your phone inbox too, including notifications the desktop kept quiet while you were watching that shard — those now fold into the summary strip instead of hiding\
• the phone inbox gets needs-you and notifications sections with swipe dismissal and card deep links\
• gems keep their identity across a relaunch (session restore and formations both), so phone links and schedules stay pointed at the right gem\
• push banners name the gem, never its directory path\
• bridge errors are clearer: malformed query parameters answer a proper 400, refusals carry the structured error body everywhere, and a common token mistake gets a helpful hint\
• the CLI refuses ambiguous gem or shard names instead of guessing, and listings no longer truncate long names\
• release and build tooling got stricter guards behind the scenes
  \

2.181.0\

August 16, 2026
\

• Two open projects with the same folder name no longer confuse --gem — commands list the matches and let you pick by id instead of silently using the first.\
• crystl workbench check, start, and uncheck now confirm the task's real state on the shared board, so multiple agents working one list stay accurate.\
• crystl history metrics adds an unattributed row so the table matches its own total, and shows a dash where token counts were never recorded instead of a zero.\
• crystl hero list and other listings no longer clip long names mid-word.
  \

2.180.0\

August 15, 2026
\

• Quest and gauntlet fan-outs no longer move your selection — new hero shards appear in the bar while you stay on your own shard.\
• Antigravity shards keep the first typed letter.\
• Codex shards are recognized as codex even when their prompt mentions another agent.\
• A hero pin that is a complete command launches its own agent, and a project-local hero without a pin now follows your agent setup.\
• Saved API keys: after an update, the keys page explains what needs authorizing and offers a one-click unlock — and a denied prompt can no longer hide or overwrite your stored keys.\
• Agent-to-agent messages no longer mangle @name mentions, while @file references keep working everywhere.\
• Quest launch messages name exactly the shards they create, and the setup preview matches.
  \

2.179.0\

August 15, 2026
\

• model@endpoint works everywhere a model can be written, including inside a command's own --model flag.\
• Built-in heroes now follow your agent setup: their size picks the model from your own configuration instead of a preset id.\
• Typing an agent's own command@endpoint spelling into a size field is caught with a hint that shows the accepted forms.\
• Quest launch messages now name exactly the shards they create, and the setup panel preview matches.\
• Restarting right after closing a shard no longer brings it back.\
• No more Keychain prompts at startup after an update — Crystl asks only when you use a keyed feature.
  \

2.178.0\

August 13, 2026
\

• Collapsed sections stay collapsed. Each gem remembers which ones you closed, and they survive switching gems and restarting the app.\
• The + section input now appears directly under the button, instead of at the bottom of the board where you couldn't see it.\
• Approvals stack in arrival order, so a new one lands where you expect it.\
• The agent activity card stays put when approvals pile up, and the floating card stack scrolls properly when there are more cards than room.\
• Heroes summon on the right model when your default agent isn't Claude. Previously a hero could hand a Claude model name to codex.\
• A model endpoint that hasn't been told its context window now says so when you start a shard there, along with where to set it — the setting that lets crystl warn you before a long session runs past a small endpoint's limit.\
• When you pick a model size that isn't mapped for your agent, crystl tells you it used the agent's own model instead of silently ignoring the size.\
• Fixed a crash that could occur when a terminal view reported an extreme window size.
  \

2.177.1\

August 12, 2026
\

• Your exact start command now wins. When the command you configured already names a model, summoning a hero at a size keeps that command as you wrote it — including choices sitting beside it like --effort high.\
• crystl agent profile set --model-via '-m {model}' works the way every message spells it. A template starting with a dash used to read as a missing value, so only the --model-via= form went through.\
• Sizes saved for a custom agent now say when they need a MODEL VIA to do anything, at the moment you save them rather than at the launch that quietly ran the agent's own default.\
• A size value that contradicts its agent row is refused with the reason instead of being kept as a model id.\
• Settings reads your saved API keys without raising a keychain prompt, and says so when the keychain is locked rather than showing your keys as empty.
  \

2.177.0\

August 12, 2026
\

• Set small, standard, and large agent profiles to either a model id or a complete start command. Exact paths, environment assignments, arguments, model choices, and effort settings are preserved across shard, hero, quest, remote, and orchestrated launches.\
• Create one-click agent facets from model endpoints while adding or editing them. crystl places the launcher in an available bar slot without treating assigned buttons as a limit on saved facets.\
• Clarify agent launch fields throughout Settings and keep endpoint model suggestions clear of the Save and Add Agent controls.\
• Stop endpoint metadata saves and background reachability probes from triggering unexpected macOS Keychain password prompts.
  \

2.176.0\

August 12, 2026
\

• Launch any configured agent consistently across shards, heroes, quests, restore, resurrect, schedules, and orchestrated workflows.\
• Preserve exact custom-agent commands—including executable paths, arguments, quoted values, and leading environment assignments—when sessions are saved and restored.\
• Configure model delivery for custom agents with MODEL VIA in Settings or crystl agent profile set --model-via, with exact-command profiles inheriting native-agent defaults when appropriate.\
• Route local and hosted model endpoints through the same launch planner while keeping endpoint credentials out of command text, logs, history, and persisted launch identity.\
• Start saved endpoint workers with a true one-click launcher facet; existing incomplete launchers upgrade automatically and use the new robot icon, which is also available for gems.
  \

2.168.1\

August 6, 2026
\

• Settings → general shows the command's status, with a banner when it needs attention\
• crystl doctor and bug reports with diagnostics now work out of the box for everyone\
• History indexing on very large, busy sessions is dramatically faster — first look in under a second, follow-ups in milliseconds\
• Shard attribution no longer rescans session folders it has already answered for\
• Storage clears run in the background and report honestly when they finish\
• Collapsed blocks that aren't tool output no longer pretend to be expandable\
• Codex shards waiting on a hook approval now show as awaiting input instead of idle\
• Last release's what's-new card retired — upgraders get this release's news, not that one's
  \

2.168.0\

August 6, 2026
\

• Durable references — every transcript row has an identity that is either correct or clearly refused, never silently wrong\
• Fast on big sessions — index requests on large, active conversations answer in milliseconds instead of re-reading the whole transcript\
• Filters — --index --tool Bash, --status error, and friends\
• Storage — Settings → Storage shows the timeline database size with a one-click compact; also crystl history compact\
• Large existing histories finish indexing quietly in the background over the first few minutes after updating\
• Typing stays smooth while agents stream — the rail's working glow and tile updates no longer compete with your keystrokes\
• Click-to-expand tool output is steadier: full output or an honest "waiting" note, never a silent collapse — and things that aren't tool output no longer pretend to be expandable\
• Codex shards remember their hook approval across updates — one trust prompt, ever
  \

2.164.0\

August 4, 2026
\

• Quests now prevent duplicate parties after relaunch and recover cleanly when hero shards remain after ending.\
• End & close handles parties of any size, identifies any hero shards that still need closing, and keeps remote replacement terminals rooted in the repository.\
• Quest Master now uses launch-specific greetings, and its read-only raw terminal has moved into the quest actions menu.\
• Worktree protection now resolves remote symlinks on the host and hardens discard ownership and remote transport trust checks.
  \

2.163.0\

August 4, 2026
\

• Quest levels now finish reliably, preserve each party member's final outcome, and show completed status with the correct level numbers.\
• Isolated shards now block destructive worktree escapes before tool execution, including Codex sessions using automatic approval modes.\
• Questline, settings, and agent guidance now use consistent vocabulary and clearer capability guidance.
  \

2.160.0\

August 2, 2026
\

• wrote to the gem's main checkout — the change is in *no* branch. It will\
• wrote into another shard's worktree — the change lands in a different\
• wrote outside its worktree — home dotfiles, system paths, global installs,
  \

2.158.0\

August 2, 2026
\

• Questlines from crystl.dev. Settings → quest → questlines has a library you can browse, plus sync from crystl.dev to pull the whole catalog down at once. Six questlines to start: onboarding tour, refactor arc, release gauntlet, security sweep, test coverage climb, and vocabulary drift. Imported questlines sit alongside the built-in ones and can be duplicated and edited like any other.\
• Convert a local JSON questline to markdown in place, so an older saved questline can be edited as a document.\
• Notifications use the name you see. A renamed shard, a hero, or a court seat now appears in notification cards and approval panels by its display name instead of its underlying crystal name.\
• Imported and synced heroes appear immediately — no app restart.\
• Facet slots show how full they are (N/8) at a glance.\
• Quest settings has tabs — quest and questlines — matching the tabbed layout in general, agents and library.\
• A rejected-credentials sync now says your membership needs upgrading rather than reporting a generic failure, and bulk questline sync is gated the same way individual imports always were.
  \

2.157.0\

August 2, 2026
\

• Codex sessions no longer lose their scrollback history unexpectedly on a resize — a clear-screen sequence Codex sends during its own redraw was being treated the same as an intentional clear.\
• crystl notify and /send are more reliable under load: notify retries automatically on a dropped response instead of failing silently, and no longer double-delivers if a retry lands after all; a sent message now submits by default instead of sometimes sitting unsent in the prompt.\
• Bridge commands (gems, workbench, merge, and more) fail fast with a clear, retryable error instead of hanging when the app is busy under heavy multi-shard load.\
• The crystl CLI starts noticeably snappier — a networking check it used to make on every single command has been skipped since it never applied to this app anyway.\
• The approval-mode setting is now Tool Approvals (modes: *ask every time / smart / auto*) — it was easy to confuse with Claude Code's own "manual mode," which means something different (edits, not tool permissions).\
• Quest's Party Size control is now Model Size — it always chose which model tier your heroes launch at, not how many of them show up.
  \

2.155.1\

July 31, 2026
\

• "Initialize git repository" is back on for a new gem in an ordinary folder. 2.155.0 turned it off everywhere, which left new gems as non-git folders: the first isolated shard was refused, and the auto-filled git remote never applied. It is now on by default, and off only when the folder sits inside a repo you already have — which was the case it was meant to cover.\
• crystl uninstall reverses everything crystl wrote outside its own app folder: Claude, Codex and Antigravity hook wiring, the CLI symlink, the bridge token, and optionally the CLI primer in your gems' agent docs. Run crystl uninstall --dry-run first to see exactly what would change. It never touches your work — gems, worktrees, crystl/* branches and saved API keys are listed and left alone. Free on every tier.\
• Turning the Codex integration off no longer disturbs a running session. Previously it removed the hook script that live sessions still called, so every tool call failed until you restarted Codex. The hook is now disabled in place instead.\
• The CLI primer can be removed. Turning the setting off stops writing new ones, and the primer already written into a project's agent docs can be taken back out — those files live in your repos, so removal is always an explicit, confirmed action.\
• Antigravity works better. Transcripts are read from agy's own JSONL log instead of reverse-engineered from its database, so turns and timestamps are accurate. Hooks with a turn-finished signal are available (off by default), crystl doctor reports installed agent CLI versions, and the model list uses agy's current ids.\
• Schedules are free up to 3 on desktop, CLI and phone. Existing schedules beyond the limit keep running.\
• The folder picker opens with nothing selected, so the button offers the folder you are looking at rather than jumping into the first child. Files are no longer selectable, and the pointing-hand cursor holds across a whole file path in the terminal instead of flickering.\
• Settings tidied. The library page uses the same tab style as the rest of settings, captions sit with the control they describe, and a control's description no longer floats halfway to the next setting.\
• Creating a gem inside a crystl worktree now warns first — that folder gets deleted along with the worktree, taking the gem with it.
  \

2.155.0\

July 31, 2026
\

• Creating a new gem now keeps Git initialization off by default. The remote field appears only after opting in.\
• Gems created inside a larger repository now default to shared shards. Creating a standalone nested repository is an explicit secondary action with a separate-history warning.\
• Documentation now maps app, gem, and shard settings and accurately describes both three-dot menus.
  \

2.154.0\

July 31, 2026
\

• Settings → general is four tabs — appearance, terminal, gems, startup — instead of one long two-column page, and it remembers the tab you were on.\
• Agents collapses from seven sidebar entries to four. A single agents page carries defaults, claude, codex and system prompts; schedules, MCP servers and API keys stay on their own. Every "open settings" link in the app lands on the right tab.\
• The file library uses the same underline tabs, so settings has one tab style throughout.\
• The folder picker finds a projects directory you already have — ~/Projects, ~/Developer, ~/dev, ~/code, ~/src, ~/repos, ~/work — instead of creating ~/Projects on your behalf. It creates nothing.\
• The picker's button says what it will do: open here for the folder you're browsing, open selected for a highlighted one, go up on the parent row. Choosing the folder you're standing in was always possible; now it's visible.\
• Creating a gem inside a bigger git repo warns at creation and offers git init here, rather than letting you find out later when an isolated shard is refused. Shared shards work there either way, so it only warns.\
• That refusal now comes with a git init here button, and clearer wording about using a shared shard instead.\
• Hovering a file path keeps the pointing-hand cursor across the whole path instead of flickering.\
• The chat dock no longer shows Claude Code's internal bookkeeping — background-task notifications and context injections — as messages you wrote.\
• cavrn is named as the recommended renderer in settings, with the xterm fallback moved below the settings you actually adjust.
  \

2.153.0\

July 30, 2026
\

• Collapsed tool-output rows in the default GPU terminal now say click to expand. Click one to open that exact Claude Code or Codex call beside the terminal without sending anything to the agent.\
• Tool calls in the chat dock expand inline to their full input and output, with a one-click copy button. Long-running calls stay live until their result arrives, while completed calls that printed nothing are labeled honestly.\
• Tool-call matching now handles deep scrollback, repeated calls, rapid clicks, dock closes, and transcript changes without opening the wrong row or freezing another result. When a match is ambiguous, crystl opens the dock without guessing.\
• Prompt navigation in the GPU terminal now lands on the command line and returns cleanly to the live tail.\
• Startup setup and error messages no longer block the app's main thread with modal dialogs.
  \

2.152.0\

July 29, 2026
\

• crystl send now waits its turn. A line you're part-way through typing and a send arriving from the CLI or your phone can no longer end up glued together as one prompt — the send waits, or tells the caller to retry.\
• Sends also stop being blocked by input that isn't there any more: a draft you backspaced away, or a keypress a full-screen app swallowed, no longer wedges every later send.\
• New crystl send --wait confirms a dispatch actually landed as a user turn in the agent's transcript, so an orchestrator knows its instruction arrived.\
• The chat dock stays inside its own column instead of drawing over the gem list on a narrow window.\
• The chat dock now works for SSH remote shards — it used to open empty and stay that way.\
• The shard bar's "+" waits a beat before dropping the creation column, so a quick click for a new shard isn't interrupted by it.\
• VoiceOver now reads settings toggles as checkboxes and shard pills as buttons, with space-bar activation and a focus ring. First pass — more of the interface to come.\
• The out-of-date demo is no longer offered from General Settings.
  \

2.151.0\

July 28, 2026
\

• Improve Quest planning: keep Save available after launch, restore quests without a Quest Master, add a raw-terminal escape hatch, and let the Quest Master use a chosen agent plus free-text model.\
• Harden Quest level-close and unblock scripts so they use the signed bundled implementation, time out whole process groups, and cannot leave grandchildren running.\
• Keep watched-shard questions and notifications out of global panels while preserving accurate shard attribution everywhere else.\
• Make merged-but-not-fully-cleaned-up shards report their real state, including whether the worktree remains available.\
• Tighten shard-bar layout and creation controls so pills use the available width and fast pointer movement stays deterministic.\
• Fix prompt detection and screenshot-hover preview lifecycle regressions.\
• Save Claude's default permission mode in the setting Claude actually reads.\
• Harden the macOS app by removing unnecessary executable-memory and library-validation exceptions.
  \

2.150.0\

July 28, 2026
\

• emoji render properly in the terminal again — including flags, skin tones, and multi-part emoji like 👨‍💻\
• crystl remembers your window size and position between launches\
• a new window opens taller, and the bars around the terminal give back space they were holding — noticeably more rows to work in\
• screenshot thumbnails are smaller, and hovering one shows it large without shifting the terminal\
• long snippets in the copy bar stay readable — text now stops before the copy button instead of running underneath it\
• the shard bar's creation icons drop down in a column on hover, so they no longer reserve width the shards could be using\
• shard pills sit a little tighter\
• split a pane and you can summon a hero into it, alongside a new or isolated shard\
• the split button now reads "close split" while you're split, and lights up so you can see it's on\
• collapsing the gems sidebar with the workbench open no longer flashes the shards behind it
  \

2.149.0\

July 27, 2026
\

• macOS gives an app launched from the Dock a limit of 256 open files. A busy crystl session — a pty per shard, file watchers, the bridge, SSH connections — uses more than that, and past the limit things fail in scattered ways: shards fail to start, watchers stop noticing changes, the bridge stops answering. crystl now raises its own limit at launch.\
• This never showed up in development, because launching from a terminal inherits a much higher limit. If you've had a long session go strange in ways that cleared up after a restart, this is a likely cause — and it may also be behind the rare crash some people see after many hours.\
• Starting a quest in your home folder now tells you why instead of reporting success for a quest that never started. Open the project's own folder as a gem and start it there.\
• CRYSTL_NOW now refreshes in non-interactive shells too, so a script reading it gets the current time rather than a stale one.
  \

2.148.0\

July 27, 2026
\

• A shard keeps showing its agent for as long as the agent is actually running. Previously the agent/status fields were driven by hook events and faded about a second and a half after each one — so a shard whose agent was mid-thought, the longest part of a turn, reported no agent at all. Presence now follows the running process, and the working time you see counts real working time rather than time since the last event.\
• This matters most for orchestration: a tool reading crystl status --json to decide whether a worker is alive no longer sees a healthy, generating agent as absent.\
• Open in Crystl now appears in Finder's Services menu when you right-click a folder. The service had been declared for a long time but was never registered in a way macOS would surface.\
• crystl:// links work in released builds. The URL scheme was declared only in development builds, so the handler in shipped copies had nothing to register it.\
• crystl's application bundle now carries the standard metadata macOS expects. Among other things, this is a candidate fix for a rare crash some people see after long sessions, reported inside the system's recent-items code — if you have been hitting that, we would like to know whether it stops.\
• When you pin the bridge with CRYSTL_BRIDGE_PORT / CRYSTL_TOKEN_FILE, an unusable pin now reports the problem instead of quietly connecting to a different bridge. Absolute paths are accepted alongside plain filenames.
  \

2.147.1\

July 27, 2026
\

• Scrolling the shard strip with a mouse works. With many shards open, a mouse wheel moved the strip by about a pixel per click — near enough to nothing that the shards past the edge looked unreachable. A trackpad was unaffected, which is why this went unnoticed. A wheel click now moves the strip a useful distance.\
• Arrows appear at the ends of the strip when it overflows, on whichever side has more shards. Clicking one moves to the next or previous shard and brings it into view.\
• Their tooltips name the keyboard shortcuts — ⌘⌃] and ⌘⌃[ — which step through every shard, including the tenth and beyond.
  \

2.147.0\

July 27, 2026
\

• The file menu in the markdown editor has a + new file action. Type a path relative to the gem — notes.md, docs/api.md, docs/design/routing.md — and any missing folders are created along the way. .md is added if you leave it off.\
• New files land where the editor can find them again: the gem root, or under docs, doc, notes, or wiki. Anywhere else and the file would be created but never appear in the list, so those paths are declined with a note about where it can go.\
• A gem with no markdown yet says so and points at the action, instead of showing an empty menu.\
• An existing file is never overwritten — the editor opens it instead.\
• crystl doctor --full counts bucket scans accurately and labels them honestly, and its transcript census names the gem without including its path — so it's safe to attach to a bug report.\
• tmux shard identity refreshes correctly when tmux runs on a named socket with clustered flags (tmux -2Lwork).
  \

2.146.1\

July 27, 2026
\

• Remote shards keep their conversation history on hosts with an unusual stat, find, or directory permissions. The faster single-round-trip listing added in 2.146.0 now checks its own result and falls back to the older per-file listing when a host can't run it, instead of reading as an empty project.\
• crystl doctor --full reports bucket scans accurately. It was counting every conversation lookup, so a healthy machine looked like it was constantly searching; it now counts only the searches that mean something is wrong, and says so when there are none.\
• tmux shard identity refreshes the gem name as well. A naming overlap meant the gem could stay stale on a long-running tmux server.
  \

2.146.0\

July 27, 2026
\

• Reading a shard's conversation over SSH used to make one round trip per past session in the project — a project with a hundred sessions meant a hundred round trips, every refresh. It's now a single round trip. Measured on a local test host: 6.8s → 0.07s for a 100-session project, and the gap widens the further away the host is.\
• The shard-identity fix from 2.145.0 now applies to agents running in tmux on a remote host, not just locally. Approvals from different panes stay separate, and hooks, transcripts, and history land on the right shard.\
• The identity refresh also now works when tmux runs on a named socket (tmux -L …), which previously skipped it.\
• crystl doctor --full reports how often crystl had to fall back to scanning a project's past sessions, and how many sessions each open gem has. Together they show at a glance whether shard attribution is healthy — and if it isn't, what it's costing.
  \

2.145.0\

July 27, 2026
\

• Shards keep their own identity inside tmux. A tmux server remembers the environment of whichever shard first started it, so panes could report a different — often long-gone — shard. crystl now keeps that identity fresh for new panes and for the next command in existing ones.\
• The practical win: two agents in tmux panes no longer cancel each other's approval prompts. They looked like the same session to crystl, so one agent's request could quietly dismiss another's. Hook attribution, transcripts, and history now land on the right shard too.\
• Panes attached from a terminal outside crystl keep working as before.\
• Reading a shard's conversation no longer scans every past session in the project first. On a project with a long history that scan ran on nearly every refresh; it's now reserved for the history panel, which is the only place that needs it.\
• A conversation that grows while crystl is reading it now stays cached instead of being re-read from the start next time — the case that matters most, since it's the transcript of whatever agent is actively working.\
• crystl doctor --full now separates "this transcript doesn't exist" from "crystl re-read a large file". They were counted together, which made healthy machines look busy.
  \

2.144.1\

July 27, 2026
\

• When you scroll a shard that's running tmux, vim, or Codex, crystl now explains it with a notification card rather than writing into the app's screen. The note tells you the wheel belongs to that app (in tmux, set -g mouse on scrolls it) and reminds you the shard's earlier output is searchable the whole time with Cmd+Shift+F.
  \

2.144.0\

July 26, 2026
\

• A party that works past its last authored level now waits quietly for the Quest Master instead of cycling. Author the next level and it picks straight up.\
• Delegating with quest_task reaches heroes on a remote host — the assignment lands in their terminal, same as a handoff.\
• Vanished heroes recover on remote quests too: crystl reaches the quest host itself and closes the level so the party moves on, with no Healer needed in the party.\
• "Continue quest" resolves the right party when your quest lives in a subdirectory of the gem.\
• --fresh keeps a plan the Quest Master just authored. Starting over from scratch is --fresh --emergent.\
• Task and handoff messages reach their recipient whatever the wording — a title that mentions @all no longer holds one back.\
• An unblock that arrives during a busy stretch is held and delivered rather than dropped, and you get a card when one is deferred.\
• Questlines with spaces in their names launch and delete cleanly.\
• Ending a quest tells you if any verb couldn't be retired, rather than reporting a clean finish.\
• Host-closes name each affected hero, and their per-quest limit now carries across a continue.\
• Scrolling holds your place through a resize.\
• Scrolling inside a fullscreen app (Codex, vim, tmux) now explains itself — you'll see the one-line note about enabling mouse mode instead of a wheel that seems to do nothing.\
• Resizes reach the engine once instead of twice, which keeps redraw bookkeeping tidy on long-lived shards.\
• Closing a shard releases its claims on unfinished tasks, so they're free for the next worker.\
• crystl workbench open --column backlog|progress|done opens the panel on the column you mean.\
• Schedules can be created and edited from the phone.\
• Sent messages settle correctly when a conversation switches underneath them.
  \

2.143.0\

July 26, 2026
\

• quest handoffs now land directly with the hero taking over — including heroes on SSH remotes — so the party picks work up right away\
• the whole party gets notified when a questline wraps up, pauses between levels, or is called off\
• a hero whose shard closes mid-stall no longer leaves its level waiting — the host wraps it up and the quest moves on\
• new staged compose panel: every report opens for your review before anything is sent, with clear hints about who sees your email and where the report goes\
• sharing to slack is your choice, with a direct-email option right up top\
• crystl doctor --full adds a health snapshot (memory, caches, store sizes) — also available to agents at GET /api/v1/health\
• a threshold watchdog leaves perf breadcrumbs in crystl.log so slowdowns are easier to pin down\
• license page: a mistyped key can now be cleared in place, and the activate button works reliably again\
• Commenting on a non-task line tells you instead of silently doing nothing, and "+ section" is now a tidy link below the tabs\
• session restore is smarter about transcripts that never existed — no more resuming into a blank session
  \

2.142.0\

July 26, 2026
\

• begin quest always starts clean — starting a new quest archives the previous chat aside automatically, so yesterday's conversation never bleeds into today's party. Picking up where you left off is the explicit "continue last quest" button.\
• saved questlines get a delete — tidy up your questline library from Settings → storage, the CLI, or the bridge.\
• quest end is dependable — ending a quest archives everything in one final step, and a quest running across SSH hosts ends everywhere or nowhere; if a host is unreachable, nothing is touched and you can simply retry.\
• snappier chat with big fan-outs — the transcript cache now keeps your busiest conversation hot, so the chat dock stays responsive while a fleet of workers streams.\
• collapsing the sidebar no longer pushes the copy and screenshot bars out of place\
• the workbench/markdown title no longer truncates on a narrow panel\
• clearing quest data from storage renders the page in place instead of into the settings sidebar\
• the quest panel always shows its own quest's activity and levels, even after switching gems\
• the quest loader's shine sweeps gently instead of parking over the phrase
  \

2.141.0\

July 26, 2026
\

• Heroes can now reach the quest master. A new quest_unblock lets a hero say the party can't proceed — a member is gone, stuck, or out of context, or the plan itself needs rewriting. The quest master answers by amending the plan or telling you. It's an unblocker, not an advisor: heroes still decide their own work.\
• A level no longer hangs when a hero's shard disappears. If a shard is closed or crashes while its level is still pending, crystl now closes that level for you so the party can advance, and says so in the quest chat. It waits a minute first, so an accidental close is still undoable with crystl resurrect.\
• Editing a questline no longer interrupts the party. Level edits show up in the quest chat as a record, but they no longer land in every hero's terminal — so refining a plan doesn't cost the whole party a turn each time.\
• The quest master's own description now covers this, so it understands the role wherever it's summoned.\
• The archive nudge is a quiet "archive done tasks" link rather than a button competing with your board.\
• Dim titles in the top band ("gems", "· shards", "· workbench") no longer look heavier than the gem name beside them.\
• The bridge now refuses to start rather than fall back to a weaker auth token if secure random generation ever fails, and no longer reuses older weak tokens. If you're on one, you'll get a fresh token on next launch.\
• Terminal command history and the shard timeline both confine their writes to your project directories.\
• Tightened validation on text arriving from a hero before it reaches the quest master.
  \

2.140.0\

July 26, 2026
\

• Entering a license key works again. Paste your key, click activate, and it goes through. If you're a Guild member who couldn't get a key to take, this is the one — no need to do anything but update.\
• A rejected key can now be corrected in place. Previously the field held onto the old key, so retries kept submitting it.\
• The Claude page now shows the effort level and default mode you actually have saved, instead of always displaying "high" and "plan".\
• Reopening an isolated shard on an existing branch now tells you when that branch has fallen behind your base branch, so an agent doesn't quietly start working on stale code.\
• Closing a shard on the xterm.js surface now releases its memory properly. If you use that surface and noticed things getting heavier over a long session, this should help.\
• Command history writes are now confined to your project directories.\
• Tightened validation on the SSH bridge address, and the SSH settings endpoint is now gated like every other setting that changes state.\
• The developer-build licensing path is compile-time only and no longer present in shipped builds.
  \

2.139.0\

July 25, 2026
\

• Transparency slider always works — dragging it on a solid background switches you to glass (keeping your tint) and applies immediately; the grab area is far more forgiving too.\
• Quieter shard bar — creation buttons slide out from the + on hover and tuck away after; pills fade at the strip edges instead of hard-clipping; the first pill sits on the shared left line.\
• Finishing touches: more breathing room in the title row; chat/quest/branches match the tab text with even spacing; + section and the turns pill sit level with their rows.
  \

2.138.0\

July 25, 2026
\

• Quest loading line matches the spark's blue, with a subtle shine sweep.\
• Facet bar sits closer to the status row.\
• The terminal, its chrome, and the gems column all share clean left rails.
  \

2.137.0\

July 25, 2026
\

• Quest activity tab uses the full panel height with tidier edge fades.\
• Workbench rows no longer stack hover highlights while scrolling.
  \

2.136.0\

July 25, 2026
\

• quests self-start: a freshly launched questline announces Level 1 to the whole party, so a headless start gets moving without a first message from you\
• sealed-quest heroes seat faster: worktrees inherit the gem's external-imports consent, and a fresh party gets a two-minute grace period before any stall reminders\
• planned questlines complete cleanly at their last level; an open-ended arc that runs past its authored levels now shows "awaiting next level" instead of a phantom next stage\
• conversation timeline reliability: a version bookkeeping mismatch that could quietly pause history search and metrics now heals itself on the next launch
  \

2.135.1\

July 25, 2026
\

• the workbench markdown picker finds more of your docs: doc/notes/wiki folders, per-package READMEs and design docs, the live quest plan, and saved questline templates — always with the full path shown\
• the quest master can retract a queued level with the new quest_level remove (freely while planning; a running quest keeps its current and cleared levels protected)\
• quest window housekeeping: the plan doc syncs only when something actually changed\
• the first-run agent card sizes to its text instead of clipping when several agents are installed
  \

2.135.0\

July 25, 2026
\

• continue quest actually continues: the Quest menu item and a one-click "continue last quest" button in the begin-quest panel relaunch your last party with its chat and questline intact\
• sealed quests resume sealed: crystl remembers whether the last quest ran open or sealed and relaunches in the same mode (the quest master's proposal still wins when it stages one)\
• stalled heroes get an automatic reminder straight in their terminal; the quest master only steps in when one stays stuck, reviewing the level brief and reporting to you\
• begin-quest panel cleanup: the PREVIOUS CHAT pills are gone (carrying the chat forward is the default; "archive chat" lives in the quest window menu)\
• The rename-shard and quest-master model prompts wouldn't accept typing
  \

2.134.0\

July 25, 2026
\

• quest master planning grows up: the quest master authors the plan doc live in your workbench editor, offers to help pick the party, and stages the begin-quest panel (heroes + sealed/open) so launch is one click\
• save a plan as a questline template: new "save as template" button in the planning tab, plus a questline dropdown in the begin-quest panel for launching saved arcs\
• quest plans now carry into fresh launches, so the levels tab shows the whole arc — progress bar, per-level barrier counts, and per-hero "level 3 in progress / complete" rows\
• a quest-flavored loading strip while agents work: looting corpses, guzzling ale, casting fireball (again)\
• quest window polish: the ready glow on "begin quest" sweeps briefly then settles calm, composer buttons share one style, and the window anchors to the quest button\
• plan editing is smoother: the plan doc and quest state stay in lockstep — your edits fold in, authored levels render out\
• keyboard shard navigation and approvals refinements: hidden quest master shards stay out of the rotation, and answering one approval leaves the rest showing\
• Stale history-database recovery backups are cleaned up automatically
  \

2.133.1\

July 23, 2026
\

• The agent's status line / spinner could smear stale text across the top rows of the terminal while the copy bar (or another bottom bar) was open during a long task — you'd see fragments like "Boo…" welded onto earlier lines until you closed the bar. The renderer now repaints cleanly once the bar settles, so the top rows stay correct.
  \

2.133.0\

July 23, 2026
\

• Worktrees panel. The shard bar's branches button now opens a " worktrees" panel that shows all your isolated work at a glance. ACTIVE lists the isolated shards running now — each row shows what it's doing (its task), the agent and model driving it, how long since it last did anything, and its commit count; click a row to jump to that shard. PARKED lists branches you've set aside, each with its commits, dirty state, and last-commit age, and gives you reattach, merge, and discard right there (discard confirms first). The list scrolls when it gets long.\
• Name isolated shards when you create them. Right-click the isolated-shard (⎇) button to name a new shard and its branch up front, so the git branch is meaningful from the start. Optional — leave it blank and crystl auto-names it as before.\
• Markdown editor in the workbench. Switch the workbench panel to raw markdown mode to edit any of the gem's .md files, with syntax highlighting, smart list continuation (Enter continues a list, double-Enter ends it), and find/replace. A searchable file picker lets you jump between docs. Agents can surface a file for you with crystl markdown show <path>.\
• Copy code and diffs from an agent's output. Hover a code block or a unified diff an agent printed in the terminal and a menu appears to copy it cleanly.\
• Your isolated-branch work is safer. The whole worktree recovery path was hardened: crystl now only deletes a branch or worktree when it's certain nothing is lost. Uncommitted changes and commits are always preserved unless you explicitly discard, a worktree whose agent is still running is never touched, and anything crystl can't positively verify is left parked rather than removed.\
• Resizable workbench and gem sidebar. Drag either column's edge to widen it; the window stays put.\
• Gems moved to the sidebar for good. The old tabs-on-top layout is retired — gems live in the sidebar, which is cleaner and avoids the stacked-tab rough edges.\
• Workbench polish. New sections add at the top instead of the bottom, the task list is less cluttered, and the pull-tab and divider line are aligned and gapped cleanly.\
• Several worktree recovery edge cases: recovering the first isolated shard's identity on restore, commit counting, and keeping worktrees when a status check can't run.\
• The code/diff detector missed blocks an agent had indented.\
• The markdown highlighter could stall while typing in large files.\
• Terminal hover stopped re-running detection on the same row repeatedly.
  \

2.132.3\

July 23, 2026
\

• Command blocks. Hover a finished shell command and a menu appears to copy the command, its output, or both — output comes back clean, with soft-wrapped lines rejoined and no prompt bleed. You can also collapse a command's output, re-run it, and jump between commands from the View menu. On by default; turn it off in settings if you prefer.\
• A rare crash that could take down the app when multiple terminals rendered clickable hyperlinks at the same time. It was a data race on a shared link table, now serialized, so heavy sessions with many shards stay stable.
  \

2.132.2\

July 22, 2026
\

• Opening a project that's already open no longer snaps your view to a different one. A background or scheduled task re-opening a project can't yank you out of the gem you're working in anymore.\
• Shards keep their names and restore correctly across app restarts. Previously a shard you hadn't opened before quitting could come back mis-named and fail to restore, and the drift got worse each restart.\
• Fixed (security): the Enter-to-approve shortcut no longer auto-allows a pending approval from a different, similarly-named project. Approving in one project can't accidentally approve a tool call in a sibling like crystl vs crystl-web.\
• Your agent's permission allowlist is now honored in every project you open. Crystl trusts the workspace on launch, so you no longer get the "this workspace has not been trusted" warning or lose your saved auto-allows.\
• After you answer a permission prompt, Crystl nudges the agent to repaint, clearing a status-line garble Claude Code can leave behind. This is a mitigation for an upstream Claude Code rendering issue, controllable via the inkReprintNudgeOnDecide setting.
  \

2.132.0\

July 22, 2026
\

• Workbench is now a kanban board: slide between Backlog, In Progress and Done, and drag cards to change status.\
• Sections are first-class group headers — collapse them like an accordion to cut clutter, and they group your tasks within each column.\
• Cards get a full edit form: title, a scrollable description, an append-only comment thread, and a button to schedule an agent for the task right from the card.\
• Your agents can now add task comments from the CLI and bridge, so a worker can leave notes on the board.\
• Tasks carry stable ids, with archive/heal for done items and a warning when a board grows too long.\
• Shard-bar pills gain rich tooltips with a hover marquee for long names.\
• Agents are version-aware: they proactively check the changelog and suggest updating when you're behind.\
• crystl docs is now a discovery tool — it surfaces page URLs so your agent can point you straight at the right doc.\
• Notifications skip the card for the shard you're already watching.\
• Faster status updates for parked workers, so a paused fan-out surfaces sooner.
  \

2.130.1\

July 21, 2026
\

• Resolve bundled resources on universal (release DMG) builds
  \

2.130.0\

July 20, 2026
\

• crystl screenshots — a read-only CLI command that surfaces your recent macOS screenshots as paths your agent can open with its image tool. Say "view the screenshot I just took," "the 5 I just took," or "the app screenshot from yesterday" and the agent resolves it to files. Local (no bridge, works with the app closed) and free on every tier.\
• Faster keystroke echo when typing into your agent. Crystl was holding screen updates behind its streaming ghost-frame protection while you typed, adding latency to each character. It now recognizes your own keystrokes and paints their echo immediately, while streaming output stays protected.\
• Restored streaming ghost-frame protection that a change in 2.129.1 had weakened during an agent's output.
  \

2.129.0\

July 20, 2026
\

• faster terminal rendering: the Prism engine now re-draws only the rows that actually changed and reuses cached rows the backend left untouched, so cursor-heavy output like progress bars, live logs, and TUIs costs noticeably less CPU. on by default, and verified byte-identical against the full-redraw path\
• the workbench done-check is a brighter icy-blue that reads clearly on dark glass, and the checkbox repaints the instant you toggle it\
• approval panels: a bounded reconcile timer sweeps away orphaned panels, so a stray approval can't linger on screen after it's resolved
  \

2.128.0\

July 20, 2026
\

• fixes a dirty git status from quest state: crystl now guarantees the .crystl/.gitignore on gem open, so quest runtime files can never show up as uncommitted changes — existing projects self-heal the moment you open them\
• toggles across settings are rounded rectangles now, matching the app's other controls instead of iOS-style pills\
• internal hardening: the terminal's frame-damage optimization gained a regression net that verifies every rendered frame against a full rebuild, and the scrollback publish cadence is safety-clamped
  \

2.127.0\

July 20, 2026
\

• notification bell in the rail: a bell above the +/folder buttons toggles all floating cards out of the way for small screens; a badge carries the count (red when something needs you), and the whole stack collapses except the always-on agent activity panel\
• crystl speaks through cards now: messages that used to print into the terminal (merge results, restore failures) would splice into an agent's live prompt — they now surface as notification cards instead, with failures headlined in red, and only print in the terminal when no agent owns the screen\
• rail polish: bell, +, and folder share one look with hover states and tooltips, and their icons now match in brightness\
• agent activity panel: more headroom above the title and more breathing room between shards\
• notification sound plays on arrival even when cards are hidden, so a muted bell still chimes if you enabled sound
  \

2.126.0\

July 19, 2026
\

• facet submit works everywhere: submit-action facet inserts now press a real Enter, so the snippet actually runs in Claude's composer (and Codex, and plain shells) instead of landing with a stray blank line\
• terminal snappier under heavy output: snapshot rebuilds are 69% cheaper, and the refresh cadence scales with your scrollback size so big buffers can't starve input handling\
• scrollback up to 10,000 rows: a new preset for day-long sessions (measured linear cost; the 2,000 default is unchanged)\
• agent activity polish: more breathing room between shards and the agent · model label sits next to the shard name\
• Cursor blink can no longer stick off after a TUI resets mid-session; ghost-frame healing now covers scroll and resize repaints too
  \

2.125.0\

July 19, 2026
\

• spinner ghosts fixed: Claude's status-line rewrites could leave spliced, stale fragments on screen that only a resize cleared. the terminal now holds frames during rewrite bursts and self-heals if one slips through\
• background shades: pick from 7 dark presets (graphite, black, navy, forest, oxblood, plum, espresso) with a glass or solid finish in Settings → general; every window and panel follows the choice live\
• quest chat renders markdown: party and side-quest bubbles now format instead of showing raw markers\
• quest scrollback: quest party members get their own scrollback default (1,000 rows), configurable in Settings → quest, so launching a full party stays light on memory\
• memory telemetry: crystl status now shows app and per-shard memory plus system pressure, so orchestrating agents can check before fanning out\
• crystl scrollback clear: agents can free a shard's retained scrollback on demand (same as Cmd+K), free on every tier\
• faster startup: session restore no longer parses the same transcripts in parallel and resolves Claude sessions directly, fixing multi-GB memory spikes at launch\
• smoother under load: the terminal builds each frame's projection once per present, and the tab bar and sidebar repaint only the parts that pulse\
• Codex shards keep their identity across lazy restores; background tints stay accurate at low opacity
  \

2.124.2\

July 19, 2026
\

• Notification cards could appear blank and get stuck on screen after Crystl ran for a while (especially overnight with many pending) — the leftover panels are now cleared correctly.\
• Choose your terminal scrollback size in Settings → General → Terminal Rendering (500 / 1,000 / 2,000 / 5,000 rows) — lower it to use less memory. Your agent's messages and the commands you run stay in history search (⌘⇧F) regardless.\
• Set scrollback per shard when launching from the CLI — crystl shard create --scrollback <N> — handy for keeping big fan-outs light on memory.\
• The agent activity panel is cleaner and easier to read — full shard and model names, aligned rows, a highlight on the focused shard, and no more cut-off status.\
• Shard tabs show more of each name before truncating.\
• More reliable isolated-shard branch handling when a shard keeps working after its branch was merged.
  \

2.124.1\

July 19, 2026
\

• Resizing the window while an agent was streaming could leave stale table fragments or ghost rows on screen that nothing repainted — resize now clears them, and scrolled-out history reveals correctly again after clearing the screen or scrollback.
  \

2.124.0\

July 19, 2026
\

• A visible terminal could freeze mid-stream when you clicked away to another app — windows now keep repainting while unfocused and only lower rendering priority in the background, so you can watch an agent work while doing something else.\
• A rare crash on very tall terminal output (Metal texture limit) — oversized frames now clip instead of crashing.\
• Tables, diffs, and other structured agent output no longer scatter or re-wrap when you resize the window — scrollback is width-immutable by default (a setting restores prose reflow for plain shells).\
• Hidden and backgrounded shards no longer spend CPU rendering off-screen, and drop to lower-priority scheduling when the app isn't focused — noticeably lighter energy use over long, multi-shard sessions.
  \

2.123.0\

July 18, 2026
\

• Typing latency: keystroke echo is now roughly 40% faster. The terminal presents damage at 60Hz with hardened scheduling, so your typing keeps up during heavy agent output instead of lagging behind it.\
• Fixed a rare blank-terminal hang that could happen after a resize or font change when there was no recent output.\
• Fixed a data race in the terminal engine's synchronized-output handling.\
• Hardened the GPU frame path: it no longer reuses an in-use surface or treats a GPU error as success, preventing rare visual corruption under heavy load.\
• Reduced worst-case memory retention in the terminal's damage tracking.
  \

2.122.0\

July 18, 2026
\

• Deny destructive git state changes\
• Inspect shell command strings\
• Move rollout parsing off bridge route queue\
• Bound Codex rollout and transcript parsing\
• Document 2.117 session-age CPU root cause\
• Retain uncovered Prism shadow damage\
• Close self-destruction bypasses\
• Stabilize no-agent scan classification\
• Fix renamed worktree branch status counts\
• Migrate timeline to unique session ownership\
• Enforce one timeline owner per session\
• Fix timeline agent and shard attribution\
• Hard-deny shard self-destruction\
• Inject guardrails for every agent\
• Fix merge source branch resolution\
• Instrument Prism damage scoping\
• Prevent duplicate Claude resumes on restore\
• Add Prism main-thread render benchmark\
• Scan until agent classification\
• Cache Prism table detection by content
  \

2.121.3\

July 18, 2026
\

• Back off the full process scan while idle\
• Reset GlyphCache atlases to 64x64 on purge\
• Break BacklogStore onExternalChange retain cycle\
• Take the 20Hz agent-glow off the full-redraw path
  \

2.121.2\

July 18, 2026
\

• Move the last main-thread git off-main (.currentBranch + panel/scan)\
• Force dark appearance so the search field isn't white-on-white\
• Resolve the accurate default branch off the main thread\
• Address code-review findings on the shard-bar + /gems perf fixes\
• Cache + off-main the /gems default-branch git spawn\
• Stop repainting the whole panel on every pulse tick
  \

2.121.1\

July 18, 2026
\

• Close a reprint burst that in-place churn holds open
  \

2.121.0\

July 17, 2026
\

• Isolated shards install npm deps reproducibly. Worktrees now provision with npm ci (locked versions, matching main/CI) and no longer start with a dirty package-lock.json. An out-of-sync lock now fails loudly instead of silently installing different versions.\
• crystl wait done works with renamed workers. Waiting on a shard by its display label (or crystal name) now matches its done signal instead of timing out.\
• Workbench writes stay in the calling shard's project.crystl workbench commands run from inside a shard default to that shard's own gem — no more silent cross-project task bleed — and warn when a write targets a different gem.
  \

2.120.0\

July 17, 2026
\

• Keeps terminals responsive during heavy agent output by enabling Crystl's off-main Cavrn engine by default.\
• Adds scheduled-agent controls to the mobile app, including viewing, pausing, resuming, and cancelling schedules.
  \

2.119.0\

July 17, 2026
\

• Fixed runaway CPU and memory use during long, file-heavy multi-agent sessions.\
• Made growing transcript updates incremental so chatty heroes no longer repeatedly read, parse, or copy their complete histories.\
• Kept timeline token metrics accurate when Claude repeats message metadata across transcript updates.
  \

2.118.0\

July 17, 2026
\

• Add a complete Scheduled Automations interface for creating, editing, pausing, resuming, and monitoring scheduled agent work.\
• Improve schedule cards and notifications with names, agent selection, launch status, and clearer one-time and recurring behavior.\
• Reorganize and polish Settings navigation, including reliable scrolling in compact windows and a read-only settings CLI/API.\
• Show each shard's agent in Crystl Rail gem flyouts, alongside its live status.
  \

2.117.0\

July 17, 2026
\

• Schedule fresh agent shards for one-time, daily, or weekday runs, with time-zone-aware recurrence and agent, model, approval, and isolation controls.\
• Workbench and resurrect CLI commands now honor --gem, preventing reads and writes from silently targeting the selected gem instead.\
• Schedule creation now warns when the target gem has no agent configuration that can be resolved at run time.\
• Sidebar chat, quest, and branches controls stay aligned with the gem title when isolated shards show pending-commit badges.
  \

2.116.0\

July 17, 2026
\

• Restored agents now lazy-load by default, activating when you visit their shard; choose automatic, lazy, or no resume in General settings.\
• Formation restores follow the same resume policy while preserving active quest continuity, hero relaunches, and shard lineage.\
• Timeline recovery now rebuilds only after confirmed SQLite corruption and preserves the complete database, WAL, and SHM set for diagnosis.\
• Agent defaults now have their own Settings page, keeping agent-specific controls together and easier to find.\
• Terminal rendering does less repeated snapshot and environment work during heavy output.
  \

2.115.0\

July 16, 2026
\

• Quest heroes now merge into their intended integration branch even when the main checkout is on another branch, with matching local and SSH behavior.\
• Remote isolated and hero shards validate explicit base refs before creation and preserve generated sealed-quest targets.\
• Clearing quest chat rebuilds Crystl-managed party rosters without losing the active party, while preserving hand-edited rosters.\
• Timeline history preserves complete user and assistant turns while keeping tool output bounded.\
• The branch picker remains stable while filtering and cleans itself up reliably when dismissed.
  \

2.114.0\

July 15, 2026
\

• Teach quest_level add in the quest-levels prompt section\
• Env contract test asserted escaped source text, not the built script\
• Compile environment contract test\
• Expose Crystl environment contract\
• Expose Crystl environment contract\
• Fold errored runs into the rail attention badge with a "!" cue\
• Roster labels a finished agent by its last kind, not "none"\
• Clear a stale run outcome when a fresh agent is detected\
• Per-gem popover is screen-aware and scrolls a large roster\
• Clear the run outcome on every working transition, not just the hook\
• Keep finished agents in the roster so their outcome is visible\
• Clearing quest chat leaves scroll/channel artifacts behind\
• Test the run-outcome → idle status mapping\
• Tint failure notification cards red\
• Roster shows run outcome: done ✓ / errored ✗ instead of bland idle\
• Record agent run outcome (success/error) on the session\
• Rename the "agents" panel header to "agent activity"
  \

2.113.0\

July 15, 2026
\

• Per-gem popover clears the rail edge\
• Compact per-gem roster popover on re-clicking a gem\
• Rail bubble stays centered, shorter tooltips, no reclick-roster\
• Rail bubble tooltip garbage + over-large hover grow\
• Agent roster scroll bar flash — update row text in place\
• Rail bubble hover + tooltip driven by the tile, not the bubble\
• Agent roster footer names the metric as tokens\
• Agent roster scroll bar no longer flashes on every refresh\
• Rail count bubbles get tooltips + a subtle hover grow\
• Agent roster — model closer to shard name, wider status column\
• Restore the thin window edge border at the true corner radius\
• Group shard creation actions in File menu\
• Align quest hero colors and context accounting\
• Reduce Prism terminal stress overhead\
• Approvals win screen budget; overflow "show" cycles them into view\
• Per-column overflow footer so top-mode columns don't clobber each other\
• Keep floating panels within screen budget\
• Remove the window frost rim; native corner is clean\
• Window frost rim is a uniform stroke, not a corner-pooling glow\
• Window frost corners match the edges (concentric outer clip)\
• Add gem and shard actions to main menus\
• File-menu save/open formation\
• User copy must not hit the OSC 52 prompt; 'allow once' must re-prompt\
• OSC 8 fix must not narrow plain-path click-to-open (Prism regression)\
• Ship OSC 8 + title-sanitize fixes; hold report suppression for decision\
• Harden terminal escape handling\
• Gate terminal OSC 52 clipboard writes\
• Fix orphaned panels when animate-out completion is dropped\
• Retire the rail settings flyout\
• Default Approval moves to Settings → General\
• Add "pause auto-approvals" to the app menu\
• Attention badge tallies awaiting-input shards with pending approvals\
• Idle badge: gem-colored, bottom-left; roster footer shows token burn\
• Rail tiles show an idle-agent count badge\
• Roster shows the model beside the agent name on the main row line\
• Roster panel uses a fixed height with an always-scrollable list\
• Roster stats line leads with the detected model\
• Roster rows show context tokens, output burn, and estimated turns left\
• Roster panel snaps into place on first show instead of flying across\
• Selected gem tile click opens the agent roster scrolled to that gem\
• Add agent roster panel (fleet view) toggled from the rail settings icon\
• Branches button counts branches without the merge arrow\
• Revival is an explicit mode, not inferred from restoredID\
• Collision reroute is revival-only; reattach and exhaustion hardened\
• Quest hero seats resolve gem-name collisions before seating\
• Mid-flight name reservation still refuses, revival reroute stays\
• Prevent shard name collisions during revival\
• Shard menu left-aligns and truncates long branch refs\
• Badge underline accent only on unselected pills\
• Ahead badge anchors to the label's left edge
  \

2.112.0\

July 14, 2026
\

• Shards now always start at the gem root, and crystl says so: creating a shard while you're cd'd elsewhere prints a one-line hint in the new shard. Right-click (or control-click) the shard buttons to open the new shard where you are instead; the File menu carries the same actions, including a new Cmd+Ctrl+Shift+T for isolated shards.\
• The isolated-shard button now lives in the shard bar next to +, with the same right-click support (option-clicking + is retired). Isolated "shard here" opens at the matching subpath inside the new worktree.\
• See what's waiting to merge: isolated shards with unmerged commits show a small up-arrow count under their tab, and merge/rebase actions now name the branch, target, and commit count. The isolation dropdown is replaced by a "branches" button that appears only when parked branches from closed shards exist.\
• Start an agent in a nested git repo and crystl offers to open it as its own gem — a dismissible suggestion, never automatic.\
• Directory tracking is fixed under the current renderer and updates the moment you cd, which also repairs click-to-open for relative paths in terminal output.\
• When creating an isolated shard auto-closes your gem's untouched default shard, the new shard now says so.\
• An isolated shard can no longer land outside its worktree through a directory symlink, and suggestion cards respect the notifications switch and "dismiss all".
  \

2.111.2\

July 14, 2026
\

• Voice dictation works in shards: Crystl now ships the microphone entitlement and permission prompt that macOS requires, so agent voice input (like Claude Code's /voice) asks for microphone access on first use instead of silently recording nothing.\
• The same fix applied across the board: agents and tools running in your shards can now request camera, contacts, calendar, reminders, photos, location, Bluetooth, speech recognition, and AppleScript automation access through the standard macOS permission prompts. Nothing is granted automatically — each capability asks on first use.\
• Local network access is properly declared for phone pairing on macOS Sequoia.
  \

2.111.1\

July 14, 2026
\

• Quest reliability overhaul: quest status, claims, summaries, and handoffs now update under a shared lock with atomic writes, so parallel heroes can no longer clobber each other's state or lose ownership during compaction.\
• Remote (SSH) quests: quest state replicates to the remote host atomically and survives sync races, preserving quest progress across reconnects.\
• Quest verbs no longer fail with "argument list too long" on large task or state files — state is passed by path instead of through the environment.\
• Party files stay lean: shared heroes no longer multiply their full instructions into party.json, and existing bloated files are healed automatically.\
• Quest scripts self-heal from a shared master copy if a shard's local copy goes missing or is only partially installed.
  \

2.111.0\

July 13, 2026
\

• Exec bits on _quest_core.py, _quest_helper.sh, quest_claim\
• Install _quest_core.py alongside quest_msg's helper; pin new handoff entry form\
• Versioned quest-scripts master with atomic 'current' symlink\
• Restore quest_claim exec bit lost in the E2BIG sweep\
• Install master quest scripts only after the single-instance guard\
• Quest verbs self-heal from a shared master copy on PATH\
• Quest verbs read tasks/claims/status JSON by path, not env (E2BIG)\
• Quest_level reads state/questline JSON by path, not env (E2BIG)
  \

2.110.0\

July 13, 2026
\

• Terminal stays responsive under heavy output floods: agent output now feeds the renderer in bounded slices with real backpressure, and scrollback composes incrementally instead of rebuilding from scratch on every write. Reading a busy shard's screen (app, phone, or CLI) now answers instantly during floods that previously froze it, and flood memory use dropped roughly 4x.\
• Turns pill overhaul: token usage is attributed to shards by session id (no more cross-shard mix-ups), the pill and chart survive app restarts by rebuilding from the shard timeline, usage math is compaction-aware, and "turns left" is measured to the point where your agent actually compacts.\
• Codex parity for turns and history: Codex sessions now feed the shard timeline (so they show up in history search and usage metrics), turn history restores for Codex shards after a restart, and Codex uses its own compaction threshold.\
• New Codex models: GPT-5.6 Sol, Terra, and Luna with their full 1.05M context windows; the Codex default is now gpt-5.6-sol.\
• Spinner and status rows no longer double or ghost under heavy streaming.\
• Reopening a remote worktree shard now cleans up the leftover default shard as intended.
  \

2.109.0\

July 13, 2026
\

• Advance detectors sample at committed geometry — fix three sampling races\
• Claude-sim samples until DONE-CSIM and the churn spans the sweep\
• Reveal-mask hold escape — a stuck mask drops after 1s instead of blanking the pane\
• TerminalCoreBackendBox forwards setOutOfBandEventHandler — sync-timeout flush now publishes in-app\
• License file self-heal + deletion logging + XCTest mutation backstop\
• Gate Prism presents while a DEC 2026 sync frame is open — spinner no longer doubles mid-rewrite
  \

2.108.0\

July 12, 2026
\

• Shard creation waits for shell startup readiness before agent launch\
• search palette: native traffic-light close; custom ✕ was buried under the backing view\
• search palette: Esc closes from anywhere + visible ✕ (field report: unclosable)\
• Agent-driven search reveal — crystl history show opens the palette pre-filled\
• Kind filter constrains in SQL, before ORDER/LIMIT (codex review)\
• Add global timeline search palette\
• storage page: outcome-first copy — say what you lose and keep, not the mechanism\
• storage page: caches in a right column so a long gem list can't bury them\
• Add storage settings page\
• session store: tri-state host locality — sshHost can no longer go sticky (codex review)\
• Ingest remote shard transcripts into timeline\
• Isolated-worktree commands scope to the owning gem\
• Invalid gem scope 404s; time-clear can't resurrect or corrupt FTS (codex review)\
• turns pill: corner-pinned to the workbench edge, shard-tinted, severity fill\
• Timeline Phase 3 — search/metrics/clear routes + CLI + ingest triggers\
• Shard-timeline store — SQLite Phase 2 (spine of the timeline model)
  \

2.107.0\

July 11, 2026
\

• wait done: --idle-fallback requires --timeout (codex review)\
• Typed worker done signal — notify --done/--blocked + crystl wait done\
• quest markers: anchor @task/@done to line start (codex review)\
• F2 inline @task markers built (bfa5ba74)\
• Inline @task/@done chat markers create and close quest tasks (F2)\
• F2 agreed design — inline @task chat markers, level-stamped not level-scoped
  \

2.106.0\

July 11, 2026
\

• Default-agent sentinel survives hero edit/duplicate and local hero files\
• heroes page: default-agent hero cards show role only, no model tier\
• default-agent ask: mention per-hero agent overrides in the copy\
• default-agent ask: dropdown picker with custom… -> Settings and cancel\
• default-agent ask: drop precedence mechanics from the dialog copy\
• default-agent ask: only fire on a real quest-button click\
• default-agent ask: all quest-selectable agents, fires unconditionally\
• Pass Claude tier aliases through instead of expanding to pinned ids\
• hero sync: absent agent ingests as the default sentinel, not a claude pin\
• Heroes resolve their agent at summon instead of pinning Claude\
• Check off remote agent-launch hardcode (fixed in f8f53606)\
• Remote auto-start shard resolves its agent instead of hardcoding claude\
• Sweep launched mobile track and shipped items\
• Quest_level start/force-complete read party.json by path, not env (E2BIG)
  \

2.105.0\

July 10, 2026
\

• Work protection: closing a shard or gem with uncommitted changes now keeps the worktree intact and asks before anything is lost, and merges refuse to discard untracked files — local and SSH\
• Fixed "allow all" acting on pending questions and fanout-worker approvals that had no visible card\
• Fixed Cmd+click opening a file once per stacked shard\
• Smart approvals now ask before destructive git commands like restore, stash, and branch -D\
• Smoother under load: chat dock transcript reads, merges, and remote shard closes no longer block the UI, and quitting waits for in-flight SSH cleanup\
• Quest messages with quotes or special characters no longer drop silently\
• Crystl events/wait can no longer miss frames, and busy polling can't starve approval taps\
• Dismiss-all count, opacity on every panel, rail tiles on quick close/reopen, and several slow memory leaks
  \

2.104.0\

July 9, 2026
\

• Redesigned the quest chat composer: the message box is now a multiline composer that matches the chat dock (Enter sends, Shift+Enter for a newline), with an insert button.\
• The insert button offers quick party prompts (post status, regroup, wind down) that drop into the composer so you can tweak them before sending. Edit or add your own in Settings, Quest, Facet Inserts.\
• The app now fades in gently on launch instead of the old zoom.\
• Simplified settings page titles (dropped the redundant "settings" suffix).\
• Fixed the wind-down questline telling heroes to run a command that was renamed, so it advances levels correctly again.
  \

2.103.0\

July 9, 2026
\

• Quest levels: heroes now coordinate through shared checkpoints. Each hero marks a level complete, and the last to arrive advances the whole party, no orchestrator required. A new Levels tab in the quest chamber shows progress.\
• Fixed a slowdown where Crystl could climb to 100% CPU after days of running, caused by unbounded terminal scrollback plus repeated full re-reads of large agent transcripts. Scrollback is now capped and transcript reads are incremental.\
• Fixed resumed quest heroes not finding quest_msg after a restart, so they reconnect with their team correctly instead of falling back to a manual workaround.\
• Startup no longer auto-resumes a pathologically large agent conversation, which could stall a shard on launch.\
• Quest chamber polish: the chat, activity, and levels tabs are restyled to match shard tabs, and the quest actions (export, archive chat, end quest) moved into a hamburger menu.\
• The session-restore options are reworded and nested, so it is clear which one reopens your gems and shards versus which one resumes each agent's conversation.\
• Smaller quest party files, isolated shards now work in freshly git-initialized gems, and assorted quest_level command fixes.
  \

2.102.0\

July 8, 2026
\

• The welcome tour now covers the copy bar and quest heroes/parties, and links straight to the iPhone companion app.\
• Welcome tour cards auto-size to their text, so longer tips are never clipped.\
• Quest commands (quest_msg, quest_heartbeat, and friends) no longer come up missing when starting a fresh quest right after updating Crystl.
  \

2.101.0\

July 7, 2026
\

• Configurable integration targets: point a gem's isolated shards and sealed quests at any branch (a release or feature line), not just main. Set a global default in Settings → Worktrees, override it per gem in the gem's worktrees tab, or use the new crystl worktree target CLI. Merges go to the target, and isolated shards now fork from it too.\
• Heads-up: isolated shards now fork from the gem's integration target (the repository default branch by default) instead of your current checkout. Set a gem's target to "current branch" to keep the old behavior.\
• Fixed the frozen "thinking" spinner: a self-healing repaint watchdog ends the occasional stacked or frozen spinner during long agent streams, so you no longer have to scroll to unstick it.\
• Cleaner table redraws on resize: better dedup of stale table copies.\
• A real Settings screen with a default-view preference and a quest-tab toggle, shard detail now opens at the latest message, plus pairing-screen polish.\
• A large batch of gem-settings panel fixes: the new worktrees tab, panel positioning, scroll behavior, and spacing.
  \

2.100.2\

July 6, 2026
\

• Tables no longer shatter on window resize: stale table frames, border skeletons, empty-cell frames, wrapped-cell fragments, and mixed-width rows are all cleaned from scrollback after narrow-to-wide drags\
• Table rows that only ever existed at one width are preserved intact rather than deleted, so no content is ever lost during cleanup
  \

2.100.1\

July 6, 2026
\

• Hero editor hints hug their fields\
• Hero editor fits laptop screens; AGENT hint no longer overlaps MODEL label\
• Path browser can ascend to filesystem root — network mounts reachable\
• Height-only grows never arm the reveal mask\
• Height-only grow masks only the revealed top band; copy bar dips 20px into bottom chrome\
• Copy bar carves the terminal content area instead of resizing the window
  \

2.100.0\

July 6, 2026
\

• Rapid double shard create no longer routes two agents into one worktree\
• Deferred resize — grid + winsize commit once on settle\
• Env-gated /debug-rows route — structured scrollback dump (glue instrumentation)\
• Adopt stale-overhang invalidation + presenter mismatch contract (core c63fa97)\
• ~40-column floors for window + split panes; document the winsize contract\
• Adopt deep-centered hanging indent (terminal-core efb9e8b)\
• Adopt hanging-indent reflow (terminal-core 7e083c0); promote narrow-reflow guard
  \

2.99.0\

July 5, 2026
\

• Deliver party messages to the quest's gem, not selectedProject\
• Sealed heroes' replies landed in a worktree-local bus nobody watches
  \

2.98.2\

July 5, 2026
\

• Rename shards without losing their identity. Shards now have stable internal IDs plus editable display names, so you can keep human-friendly labels without breaking session restore, history, formations, CLI targeting, or mobile prompts.\
• More reliable shard targeting. Bridge and CLI commands resolve stable IDs first, then unique display labels, and reject ambiguous duplicate names instead of silently routing to the wrong shard.\
• Side quests stay connected to the right agents. Side-quest routing now uses hidden stable route names while showing the readable shard labels in the picker and turns panel.\
• History and restore polish. Reopened shards keep their original session identity, worker lineage resolves by stable shard ID, and the history viewer shows current custom shard names where possible while preserving older original names.\
• Agent safety fixes. Option+Deny now asks before aborting a whole session, Codex permission decisions use the required nested payload shape, resume prompts are agent-neutral, and PTY sizing is reasserted after spawn so TUIs do not start squished.
  \

2.98.1\

July 4, 2026
\

• Security hardening for license validation. Tightened how Guild membership is enforced so it can't be bypassed in shipped builds. Recommended update for everyone.
  \

2.98.0\

July 4, 2026
\

• Antigravity is now a first-class agent. Google's agy (the Gemini CLI's successor) can be picked for heroes and quest parties with full model + persona support, and launches with the right binary. It replaces the sunset Gemini CLI in the agent picker.\
• Resurrect brings back Codex and Antigravity conversations, not just Claude. Reopen a recently-closed shard (Cmd+Shift+T) and it resumes the actual session — codex resume / agy --conversation — instead of starting the agent fresh.\
• History and resurrect now track each shard by instance. Two shards that share a crystal name no longer show or resume each other's conversation — each resolves to its own session exactly.\
• More reliable agent transcripts. Fixed a case where launching crystl from inside another agent session could stop shard agents from saving their history, which broke history, resurrect, and resume.
  \

2.97.1\

July 4, 2026
\

• Chat dock fixes — reliably shows the conversation now (fixed a session-resolution bug that could leave it empty), no longer ghosts over the terminal after opening Settings, and has a close ✕ in the top-right.\
• crystl history shows token & model metadata — each turn carries its model + token usage + duration, with a session summary (tokens, tool calls, models, active time) on top; --json emits the full metadata. Useful for judging an agent's cost and context.\
• Drag-to-scroll selection — dragging a text selection past the top or bottom edge now auto-scrolls and extends it.\
• Everyone lands on cavrn — anyone stranded on the retired SwiftTerm renderer is moved to cavrn's Metal GPU terminal, with the announcement card and a "learn more" link to the docs.\
• Fresh-start launch — hold Option while opening Crystl to start with no restored gems.\
• Copy-table ⋯ — now detects box-drawing tables and anchors just to the right of the table.
  \

2.97.0\

July 4, 2026
\

• Remove crystl block command + agent instructions\
• Revert desktop chat-view reuse (empty-dock regression)\
• Pin box-drawing tables through the hover-copy hit mapping\
• Hover-⋯ copy: scan viewport with unified TableDetector\
• Detect box-drawing tables via a shared TableDetector core\
• Render the VM's stable-id entries in the conversation list\
• Stable-id conversation entries + no-op refetch skip for the phone\
• Pin chat view reuse with DEBUG measure/build counters\
• Reuse worker-thread bubbles + cache measured sizes in ChatThreadView\
• Reuse chat dock row views across streaming updates\
• Add ChatListDiffer: pure prefix diff for chat view reuse\
• Bump terminal-core pin to 494214f (live tables clip, not scatter, on narrow)\
• Bump terminal-core pin to 0acfa47 (markdown table rows clip, not scatter, on narrow)\
• Add detected-table hover ⋯ copy (raw / CSV / JSON) on the Prism surface\
• Add CrystlKit markdown-table detector + DetectedTable model\
• Detected-table copy + mobile render (parse what Claude draws)\
• Bump terminal-core pin to 0646633 (passive blocks — let Claude draw)\
• Prism harness: block scenario asserts the passive drawn-inline model\
• Prism adapter: keep block regions in frames, region-based hover lookup\
• crystl block: emit the full drawn fallback everywhere, drop c=1\
• Spec PIVOT 2: let Claude draw — blocks passive, hover ⋯ as backup\
• Block anchor hover ⋯ actions menu (copy as markdown/tsv/json + view)\
• Bump terminal-core pin to c9bf51e (reflow root-cause fixes)\
• Bump terminal-core pin to b442e50 (synthetic box-drawing glyphs)\
• Spec pivot: blocks as hover ⋯ copy/download/share, not auto-open viewer\
• Bump terminal-core pin to 530d57d (compact anchor persists across repaints)\
• Update anchor byte expectations for the c=1 compact param\
• Pin terminal-core 625a65a (accordion compact projection) + accordion viewer\
• Update block CLI snippet copy for the accordion viewer model\
• Accordion block viewer: one-row anchor + native viewer panel\
• Quiet native block fallback: anchor row + spacer footprint\
• Bump terminal-core pin to e1a8f4f\
• Bump terminal-core pin to b546555 (tmux-anchored narrow reflow)\
• Bump terminal-core pin to 0694602 (run/row-sequence reprint dedup)\
• Bump terminal-core pin to ae73c59 (selection row-range clamp crash fix)\
• Bump terminal-core pin to 57e3a03 (streamed-reprint dedup)\
• Bump terminal-core pin to a70b6b9 (resize-reprint frame dedup)\
• Bump terminal-core pin to 1561660 (in-place TUI replay around closed blocks)\
• Bump terminal-core pin to f5e06ca (frozen-scrollback block-tag fix)\
• Keep top-clipped block regions native in Prism scrolled viewport\
• Bump terminal-core pin to 36778ac (top-clipped block rowOffset fix)\
• Bump terminal-core pin to 5ba8791 (soft-wrapped table fallback residue fix)\
• Fix xterm resize during async writes\
• Add glass background SGR rewriter for near-black badge backgrounds\
• Trim CLAUDE.md: tighten Agent Support intro + obsolete SwiftTerm aside\
• Trim CLAUDE.md: collapse Typography token enumeration\
• Trim CLAUDE.md: condense the file map to non-obvious entry points\
• Trim CLAUDE.md: move glass-readability runbook to swiftterm-notes.md\
• Trim CLAUDE.md: move Bridge API endpoint catalog to docs/bridge-api.md\
• Fix Prism showing stale content after a shard shrinks below its content height then grows back (#55)\
• Bump terminal-core pin to df3bc8d1 (Prism table-fallback-residue fix) (#53)\
• Fix Prism live-resize cadence\
• Reconcile settings cleanup with cavrn-default flip\
• Bump terminal-core pin to ba95ae5 (block persistence + chrome extent + CRLF capture fix)\
• One-time "say hello to cavrn" card for existing users\
• Simplify TERMINAL RENDERING to cavrn default + xterm fallback\
• Make cavrn (Prism) the default terminal surface\
• Clean up terminal rendering settings\
• Pin PTY == engine == layout width in the harness past launch\
• Seat hidden stacked shards when the workbench drawer opens
  \

2.96.2\

July 2, 2026
\

• Fixed tables and wrapped lines getting permanently mangled when the window is narrowed while an agent is still streaming output. The row under the cursor was being cut short during the resize and never recovered; it now reflows like every other line, so mid-stream resizes are safe.
  \

2.96.1\

July 1, 2026
\

• Fixed a quest party starting with helper scripts installed for only one hero. When you launched a party, only one hero got its quest_* toolkit (quest_msg, quest_heartbeat, quest_task, quest_summary, quest_handoff, quest_claim) — the other heroes were left without them, and their PATH could point at an unrelated project. Every hero in the party now gets its full toolkit provisioned into the correct per-shard folder.
  \

2.96.0\

July 1, 2026
\

• Fixed quest agents going silent after you clear the chat history. Clearing chat used to move the quest helper scripts (quest_msg, quest_heartbeat, and the rest) out from under running quest shards, so agents could no longer post to the party until they rebuilt the scripts themselves. crystl now reinstalls them the moment you clear, so the party bus keeps working.\
• 'crystl sidequest start' can now pair shards across different gems. '--gem' is optional, and each endpoint can name its own gem as '/', for example: crystl sidequest start --a web/garnet --b app/citrine. A bare shard name with no --gem resolves across every open gem.
  \

2.95.0\

July 1, 2026
\

• Gem settings now opens right next to the gem you clicked, and you can drag the panel anywhere.\
• Gem settings scrolls internally when it gets tall instead of running off the bottom of the screen, on both the identity and agents tabs. The enable toggles on the right no longer get clipped.\
• The side quest shard picker now lists every open shard on both sides, including plain shells, with a count so you can always find and scroll to the one you want.
  \

2.94.1\

July 1, 2026
\

• Fixed an occasional black frame when opening or switching terminal tabs — a safety timer now clears the overlay if the terminal's redraw acknowledgement is delayed.
  \

2.94.0\

June 30, 2026
\

• Lead-color dots — a worker spawned by an anointed orchestrator shows a small dot in its lead's crystal color, so you can see at a glance which orchestrator a worker belongs to and group siblings by color.\
• Orchestrator visibility — the bridge/API and CLI now surface which shard is the orchestrator and, for a worker, its lead's name (isOrchestrator / leadName).\
• Side-quest CLI — crystl sidequest start/end/status plus bridge routes, so you can spin up and track a focused side conversation from the terminal or phone.\
• Hover-only close — the shard-bar close × now appears only on the pill you're hovering, keeping the bar uncluttered.\
• Restored Codex shards keep their agent — a Codex shard no longer comes back as Claude after a restart.\
• Thinking-doubling / overlap — the terminal now refits when bottom chrome changes its height, fixing stacked spinner frames and separator rules drawn through text during heavy agent churn.\
• Retired the auto-start-Claude setting (a default agent launched in every new shard); new shards start at your own shell.
  \

2.93.0\

June 30, 2026
\

• Agents are now time-aware: every shard gets the current time (CRYSTL_NOW), and the workbench and quest streams timestamp when items and messages happen\
• crystl shards / status now show how long each agent has been working or idle and when it last produced output — so an orchestrator can spot a stuck fan-out worker at a glance\
• More readable dimmed and secondary terminal text on the glass background
  \

2.92.4\

June 30, 2026
\

• Improved readability of dimmed and secondary terminal text on the glass background
  \

2.92.3\

June 30, 2026
\

• Much faster startup with many shards — the shard you're looking at loads first, and background terminals no longer pile up in memory\
• Fixed faded grey typed input in the terminal — it now renders clearly readable\
• Claim a task by adding @name to its line — shows a coloured pill you can clear with a click\
• Cleaner spacing between active task cards
  \

2.92.2\

June 30, 2026
\

• Switching back to a shard no longer flashes blank — its last screen shows instantly while the live terminal catches up\
• Fixed the terminal occasionally not repainting after the copy bar opens
  \

2.92.1\

June 30, 2026
\

• Fixed terminal text overlapping or garbling when opening the workbench drawer or chat dock\
• Fixed the workbench board rendering garbled when its file used Windows-style line endings\
• The workbench drawer now auto-opens only when items are added, not on edits or check-offs
  \

2.92.0\

June 29, 2026
\

• Lift dim text to readable contrast in xterm shards\
• Refit xterm terminal when the backlog drawer toggles\
• Send newline on Shift+Enter in xterm shards\
• Stack side-quest picker columns vertically\
• Filter side-quest picker to agent shards
  \

2.91.1\

June 29, 2026
\

• Improved remote shard readiness checks so SSH-backed sessions wait for the correct shell state before continuing.\
• Tightened bridge routing, transcript handling, and clean-port test coverage for safer release validation.\
• Fixed bottom dock layout clamping and refreshed several CLI/doctor/resurrect paths.
  \

2.91.0\

June 29, 2026
\

• Added crystl gauntlet to launch a release-readiness crew with two Seekers, one Monk, and one Scribe.\
• Solo hero shards now accept opening tasks with --prompt / --task, including crystl shard create --hero ... --prompt ....\
• Updated the agent-facing CLI docs so spawned agents know how to use gauntlet and hero task prompts.
  \

2.90.1\

June 29, 2026
\

• Fixed screenshot and copy bars overlapping or staying offset after chat, sidebar, and backlog layout changes.\
• Fixed xterm terminal colors so Claude and ANSI-colored output render consistently with SwiftTerm.\
• Prevented inherited no-color tooling settings from making new Claude sessions render without color.
  \

2.90.0\

June 29, 2026
\

• New crystl doctor command checks CLI install, bridge connectivity, and hook wiring before debugging approval or notification issues.\
• New crystl resurrect command can list and restore recently closed local shards from the command line.\
• Expanded CLI automation for Workbench tasks, event streams, wait conditions, AskUser prompts, and SSH bridge routing.\
• Improved remote SSH support for Codex shards, including notification and hook routing.\
• Hardened shard resurrection so closed shards recover more reliably with their name, color, isolation state, and agent session.
  \

2.89.0\

June 29, 2026
\

• xterm is now the default terminal renderer, with SwiftTerm still available as a fallback.\
• Terminal rendering settings now clearly separate xterm WebGL from SwiftTerm Metal GPU rendering.\
• Added a terminal font picker for installed monospaced fonts, including Nerd Fonts installed through Font Book.\
• Added a terminal renderer benchmark harness for comparing SwiftTerm Metal, SwiftTerm CoreText, xterm canvas, and xterm WebGL.
  \

2.88.1\

June 29, 2026
\

• Side quest: the shard picker now shows each shard's full name and colors it by its crystal, so you can tell exactly which two shards you're connecting. Long names scroll into view on hover.\
• Fixed the command-line-tool description getting clipped behind the install status.
  \

2.88.0\

June 29, 2026
\

• New default terminal engine: a faster, more reliable xterm.js renderer that fixes the resize glyph-scatter and redraw glitches.\
• Your existing shards are unaffected. New shards use the new engine automatically.\
• Prefer the old engine? Flip back to SwiftTerm anytime in Settings > General > Terminal Engine.\
• Plus 30+ terminal improvements under the hood: clipboard and paste hardening, click-to-open, file and image drop, split-pane focus, crash recovery, and hibernation for hidden shards.
  \

2.87.0\

June 28, 2026
\

• Approval, question, and notification panels no longer steal focus to a background agent. Your typing stays where you are, even during fan-out.\
• The side-quest panel now shows its shard picker (it was being cut off).\
• The turns button no longer overlaps the working directory path or long URLs.\
• Push-based orchestration. Fanned-out worker shards notify their orchestrator the moment they finish or get blocked, so the lead never has to poll.
  \

2.86.1\

June 28, 2026
\

• Fixed the castle marker so it only appears after the anoint briefing is actually delivered to an agent.\
• Cleared legacy false-positive anoint state on restart so plain shards do not keep the castle icon.
  \

2.86.0\

June 27, 2026
\

• Multi-agent chat (Phase 2): click a worker in the chat dock's workers tab to read its full lead↔worker thread inline.\
• Anoint an orchestrator: the new "anoint" button (crown) sets a shard up to coordinate workers; it fires the briefing straight into the agent and confirms inline.\
• Orchestrator shards now wear a castle marker, and the workers tab shows live worker status — both survive an app restart (worker lineage now persists).\
• The start panel always fits on screen (the start button can no longer hide below the Dock), with a "local heroes" disclosure and a draggable panel.\
• A clearer inline "continue / start fresh" resume choice replaces the old second window, and the misplaced non-quest shard restore is gone.\
• The "end quest" dialog now guides the decision — it shows each sealed hero's branch state and offers "end & keep" vs "end & close", with the explanation tracking the button you hover.\
• The pulsing quest-recall tile in the rail now comes back after an app restart instead of disappearing.\
• Security & reliability hardening: stricter shell-escaping on shard cwd, quest hook input validation, image-upload path confinement, decision validation on the legacy bridge route, and honest failure reporting when an API key can't be saved to the Keychain.
  \

2.85.1\

June 27, 2026
\

• Fixed a memory leak — closing a shard or gem now frees the agent's memory. Previously an agent process could survive close and accumulate over a long work session.\
• Agents can no longer override your gem's approval setting. If you set a gem to auto-approve, a fanned-out worker won't silently re-introduce the prompts you opted out of.\
• The shard bar no longer fights your scroll — with many shards open, a "thinking" shard no longer snaps the bar back to itself, so off-screen shards stay reachable.\
• Custom-named shards always get a color instead of an occasional colorless label.\
• crystl wait awaiting|idle — block until a fanned-out worker parks on a prompt or finishes its turn (for agent orchestration). The chat workers tab now reads "● W/N active".
  \

2.85.0\

June 27, 2026
\

• New — multi-agent orchestration view in the chat dock. When an agent fans out workers (crystl shard create), the chat dock (Cmd+Y) surfaces them in a workers tab: a live, recency-sorted roster (status · activity · unread) with filters. Zero workers = exactly today's 1:1 chat, so it only appears when you fan out.\
• Workers no longer stall invisibly.crystl shards and crystl status now flag a worker parked on an in-terminal approval prompt with ⏸ awaiting input (and over the live event stream) — a blocked fan-out worker is visible instead of silently stuck.\
• Fixed: the chat dock could show the wrong worker's conversation when several non-isolated agents ran in one project — each shard now resolves to its own session.\
• Fixed: chat answers could lose chunks — a big reply followed immediately by a tool call no longer drops text from the dock.\
• CLI:crystl close now works on gem names with spaces, and reopening an already-open gem focuses it instead of duplicating the tab.\
• Quest hygiene: per-shard quest helper directories are cleaned up on close instead of piling up.
  \

2.84.1\

June 26, 2026
\

• Fixed a regression from 2.84.0 where resuming a normal (non-quest) session could inject a stray "re-read the recent quest chat" prompt. Resume now only adds the quest continuation prompt for actual quest heroes.
  \

2.84.0\

June 26, 2026
\

• Fixed a freeze where Crystl could hang for up to a minute. The agent process scan and git-repo checks no longer run on the main thread, so heavy sessions stay responsive.\
• Fixed resuming a quest. Reopening a quest now restarts each hero's Claude session with a continuation prompt instead of failing to come back.\
• Fixed Return not always submitting in the chat dock. Typed messages now reliably send (bracketed-paste + retried Enter), including multi-line.\
• Fixed the chat dock dropping an agent's answer (it would flash in then vanish on the working→idle edge), plus a related case where one shard's conversation could linger after switching shards.\
• Hardened the gem-sidebar layout so the terminal stays correctly sized below the shards bar, split panes included.
  \

2.83.0\

June 26, 2026
\

• A new insert button brings your facet prompts straight into the chat composer, grouped by slot in a compact, scrollable list. Pick one to stage it for editing, or have it send right away.\
• A typing indicator now shows while your agent is working, matching the phone.\
• More reliable agent spawning: a first prompt that contains apostrophes or quotes no longer breaks a new shard's launch.\
• The turns-left indicator now sits centered under the terminal and no longer overlaps long file paths or URLs.
  \

2.82.0\

June 25, 2026
\

• Heroes now come from crystl.dev. Fresh installs ship with the 15 core preset heroes (no download), and Settings → Heroes → "sync from crystl.dev" pulls the full roster on demand. crystl.dev is the source of truth; each hero carries its agent and model.\
• New "end quest" button right in the quest panel header — end a running quest in one click (heroes return to normal solo shards). Also available as crystl quest end and over the bridge.\
• Quest party roster only shows actual heroes now. A regular shard that happened to be open in the gem no longer gets pulled into the party.\
• Hero file claims moved to the Activity feed. The roster stays clean (name, role, context health, status); who-locked-which-file now reads as activity.\
• Clicking a DM channel or party member while on the Activity tab now switches you back to chat so you actually see the conversation.\
• Add items to a specific section with a per-section "+ item" button (always visible). Section titles type in caps to match how they render. The panel title is larger so it outranks section headers.\
• Quest panel buttons unified to a single bordered "turns button" style with consistent corners; "open quest" stays a pill.
  \

2.81.0\

June 25, 2026
\

• Pin the chat composer to the bottom of the dock column\
• Start the copy bar right of the chat dock column\
• Keep the chat composer fixed when the screenshot bar toggles\
• Make rendered links clickable in the chat dock\
• Keep the turns button clear of the cwd path label\
• Syntax-tint fenced code blocks in the chat dock\
• Render horizontal rules in the chat-dock markdown\
• Render blockquotes in the chat-dock markdown\
• Accept image drops into the chat-dock composer\
• Add a gap between the screenshot bar and the chat composer\
• Render markdown in chat messages instead of raw text\
• Seat chat dock in the terminal content band so the composer clears the screenshot bar\
• Coalesce re-entrant drawer rebuild to stop doubled rows\
• Clear working state on StopFailure, not just Stop\
• Never steal focus on programmatic shard create\
• Submit the composer on Return via keyDown\
• Correct shell quoting in quest_msg helper guard\
• Abort quest_msg if _quest_helper.sh missing; copy helper before producer\
• Drive the chat dock off real-time events, not a 2s poll
  \

2.80.5\

June 24, 2026
\

• Make the composer reliably grab the caret
  \

2.80.4\

June 24, 2026
\

• Show checkmark on the View-menu toggle-chat item\
• Tear down chat dock when its shard/gem closes out from under it\
• Re-target chat dock synchronously on shard/gem switch\
• Close stale background default shard on remote isolated create\
• Quest tile renders white and shimmers while the quest is live\
• Desktop chat-mode dock for agent conversations
  \

2.80.3\

June 23, 2026
\

• Inset the pinned creation cluster from the window edge\
• Let the panel go behind other windows (drop floating level)\
• Shorten message input to the chat column, not full window width\
• Clamp party roster scroll region above the input bar\
• Stop quest/isolation labels collapsing in sidebar (stacked) mode\
• Keep Isolation/quest labels from collapsing at high shard counts\
• Scroll party roster so large parties don't spill off-screen
  \

2.80.2\

June 23, 2026
\

• Make Quest popup draggable by its top bar\
• Use defaultBranch for advisory diff refs\
• Refuse remote isolated restore on worktree-create failure\
• Surface branch-reattach failure distinctly from generic failure\
• ShellEscape the local quest temp-file path\
• PATH floor so launchd/Finder launches can spawn a shell\
• Confine POST /gems open-path to $HOME\
• Insert -- before host in ssh terminal-send sites\
• Refuse merge/rebase when primary checkout is off the default branch\
• Insert -- before ssh host in every RemoteSession argv\
• Reassert token file mode 0600 on every rewrite\
• Never degrade a failed isolated create onto the primary checkout\
• Validate OSC 7771 ssh host/control-path before storing\
• Constant-time bearer-token compare\
• Add scripts/verify.sh — one-command renderer/engine gate\
• SwiftTermEngine adapter + TerminalRenderHooks (sole backend)\
• Define TerminalEngine protocol + EngineCursor (CrystlKit)\
• Read-only DEC mode 2026 sync instrumentation (gated)\
• Schedule a draw on sync-frame edges so the widened dirty range is consumed
  \

2.80.1\

June 23, 2026
\

• Show pointing-hand cursor over the Copy button\
• Wordmark → brand serif logo lockup (splash + pairing)\
• Self-reconcile the orchestrate prompt so improvements reach all users
  \

2.80.0\

June 23, 2026
\

• Update app icon to the new gradient-crystal mark\
• Free the iPhone app over LAN; keep "from anywhere" Guild (Apple 3.1.1)\
• Default bug-report reply email to the licensed account\
• Persist gem/shard layout on every change so restore survives crashes\
• Full-rebuild on shard re-show (belt-and-suspenders)\
• Tighten hidden-shard guard (drop alpha clause, add re-show repaint)\
• Don't draw hidden/stacked shards (Metal bleed through glass)\
• Apply Crystl renderer patches as source\
• SwiftTerm v1.12.0 source in-tree (pristine upstream)\
• Crystl render --dump-cells — offline bytes→grid dump\
• Headless bytes→grid render seam for the agent-first harness\
• Vary injected CLI snippet intro by build identity
  \

2.79.0\

June 23, 2026
\

• Draw the handle brighten in the view itself\
• Pull-tab signal is a slow brighten, not a faint sweep\
• Make pull-tab shimmer sweep vertically\
• Arm the file watch before the workbench file exists\
• Prevent pull-tab shimmer from double-stacking\
• Close orphaned default shard on background isolated create\
• White quest tile that pulses + shines while agents work\
• Don't steal focus on background/CLI shard creation\
• Shimmer the pull-tab handle when an agent adds items\
• Make the quest chat window closable\
• Replace confusing goal placeholder with system-voice orientation
  \

2.78.0\

June 22, 2026
\

• Default to Claude Code's classic renderer in Crystl\
• Raise scrollback to 2000 lines\
• Align question text's left edge with the header\
• Stop the layout pass from restretching the panel to 360pt\
• Auto-dismiss question/notification cards a beat after "show"\
• Don't let a stale questAgents entry override the live hero\
• Make the agent field a plain text box that reliably saves\
• Inject persona for custom quest-party agents + agent-field hint\
• Open-ended agents for heroes and quest roles\
• Accept any CLI as a custom spawn agent\
• Require movement before a library row starts a drag\
• Skip the bare-shell guard on remote shards\
• Don't touch existing users' bar when seeding orchestrate\
• Guard orchestrate against a bare-shell paste\
• Orchestrate-specific upsell instead of the generic Guild pitch\
• Drag-reorder slots & library, primary treatment, view button\
• Add Guild-gated orchestrate facet
  \

2.77.3\

June 22, 2026
\

• Stop the focus-report storm that froze focus-reporting TUIs\
• Open links async so click-to-open can't strand keyboard focus
  \

2.77.2\

June 22, 2026
\

• Don't carry a text selection across tabs\
• Revert "fix(copy-bar): make only the active tab chip read as selected"\
• Make only the active tab chip read as selected\
• Keep selected text readable with a tinted selection\
• Use overlay scrollers so text isn't wrapped short by the scroller gutter\
• Show a pointing-hand cursor over the Copy button\
• Reclaim terminal focus on click so the caret isn't stranded\
• Stop a background TUI shard from stealing the window's scroll
  \

2.77.1\

June 22, 2026
\

• Route a background-gem push to that gem, not the foreground bar\
• Auto-hide the scroller so it stops overlapping the Copy button\
• Make the copy bar per gem instead of window-global\
• Don't report a TUI's dim ghost-suggestion as typed input\
• Give the copy button a solid background\
• Hand keyboard focus back to the terminal on Esc
  \

2.77.0\

June 22, 2026
\

• Auto-close a delegated task when its summary lands\
• Collapse chat/tasks/summaries into Chat + Activity\
• Keep the quest window from vanishing + always-recallable chat\
• Keep sidebar health bars up across transient agent-detection misses\
• Show the active party name in the quest window header\
• Move file-claim noise out of chat into the sidebar\
• Stop blanking hero roles in the chat sidebar
  \

2.76.2\

June 21, 2026
\

• Make crystl copy free on every tier\
• Editable docked copy bar with shard-colored tabs\
• Crystl party list/create/delete\
• Reveal hero stat card on click, not hover\
• Committable named party templates via "create local party"\
• Flip dropdown above the bar when it would fall off-screen
  \

2.76.1\

June 21, 2026
\

• Show custom heroes in the solo summon picker
  \

2.76.0\

June 21, 2026
\

• A party new to a directory starts on a clean chat\
• Only prompt "continue?" when relaunching the party that owns the chat\
• Dedup-proof the add-member dropdown + drop picker diagnostics\
• Party popup deduped duplicate-titled parties, breaking selection\
• Select popup after add-to-hierarchy + prune orphan party files\
• Defer party-popup relayout so the selection commits\
• Move "edit parties" out of the party popup\
• Name shards after the real hero + repaint chooser popup title\
• Launch the party the user selected (capture rendered selection)\
• New party starts empty + header reads "new party"\
• Make + add member dropdown exclude by identity, not label\
• Show a party member's real hero name, not its label's catalog match\
• Constrain YOUR CHARACTER bar to one column width\
• Move YOUR CHARACTER to Heroes page + fix roster overlap\
• Unclip continue-quest button + always show selected party\
• Preserve typed party name + dedup by identity in editor\
• Stable hero identity on party members + local parties
  \

2.75.10\

June 21, 2026
\

• Fixed a crash while a Quest is running. The app could hard-crash (and take the window down) when a quest party was active — the quest panel's color lookup choked on a duplicate member name. It now tolerates duplicates safely.\
• Quest messages no longer leak between projects. If you switched to another gem while a quest was still running in the first, that party's chat could get injected into the wrong project's shards. Quest delivery now stays scoped to the gem the quest is actually running in.
  \

2.75.9\

June 21, 2026
\

• Quest announcements post once, not N times.quest_announce now drops a single line in #quest and pokes each hero's terminal once, instead of fanning out a copy per teammate — roughly half the chat noise gone, and broadcasts reliably reach everyone.\
• The party narrates what it's doing. Claims, task hand-offs, and summaries now show up as compact lines in the #quest chat, so you can follow (and jump into) the coordination without reading every agent's prose.\
• Live hero health + roles. Quest heroes now report their real role and context level even with the chat panel closed, so the health view and auto-recovery have live data instead of blanks.\
• The party you pick is the party you get. A custom hero you made by duplicating a built-in no longer sneaks into a party by sharing the original's role — party membership stays exactly what you selected.\
• Fixed a crash from tooltips. A use-after-free when tooltips were shown could crash the app; tooltip owners are now retained correctly.\
• Cleaner hero migration. Stopped a one-time migration from cloning built-in heroes as stray "(custom)" duplicates.
  \

2.75.8\

June 21, 2026
\

• Refuse to start a quest rooted at the home directory\
• Size the editor panel so the save button is on it\
• Persist heroMode across show()'s internal dismiss\
• Persist --status from quest_heartbeat
  \

2.75.7\

June 21, 2026
\

• Persist quest-bus membership so chat survives restart\
• Keep the editor's save button on-screen
  \

2.75.6\

June 21, 2026
\

• Show quest-party shard costumes in hover card + profile modal\
• Re-resolve party members against live catalog at launch\
• Point Sparkle zip enclosure at the download proxy
  \

2.75.5\

June 21, 2026
\

• Ship Sparkle updates as a zip, not the DMG\
• Hover mini card + expand to full profile modal\
• Restore hero costume on last-session relaunch
  \

2.75.4\

June 21, 2026
\

• Blank the chat topic line instead of a bare #quest label\
• Allow standalone self-summary without --task-id
  \

2.75.3\

June 21, 2026
\

• Stop quest heroes inheriting the selected shard's cwd\
• Bind staggered summon to target gem by identity
  \

2.75.2\

June 21, 2026
\

• Show gem icon in quest chat header + fix pill label\
• Validate + lowercase hero names at save\
• Materialize hero shards when party uses custom heroes
  \

2.75.1\

June 20, 2026
\

• Kill multi-agent terminal text overlap via per-row content hash
  \

2.75.0\

June 20, 2026
\

• In-app create/edit for local heroes + LOCAL column polish\
• Read charter from hand-authored .crystl/heroes JSON\
• Persist hero charter through party.json round-trip\
• Author charters for the built-in hero catalog\
• Scaffolded Charter field in the hero editor\
• Inject hero charter into quest + solo system prompts\
• Add QuestRole.charter field\
• Align columns, color names, dupe, LOCAL header/subheaders\
• Custom heroes selectable + resolvable in quest parties\
• One-time migration of flat overrides into custom heroes\
• Dedicated Heroes settings page + slim the Quest page\
• Stop writing flat override dicts for built-in edits + library import\
• Duplicate-&-edit built-ins into named custom heroes\
• Fold global custom heroes into catalog + /heroes with precedence\
• CustomHeroStore global CRUD + dupe guard\
• Add CustomHero record + LocalHero avatarId\
• Find bar lands on the topmost match; note count is a hint\
• Collapse split to a single Cmd+D toggle; drop dead pane items\
• Cmd+F find in scrollback\
• Cmd+Opt+1/2/3 facet-slot hotkeys\
• Gem/shard/pane navigation + Cmd+K clear\
• Add crystl shard close\
• Gate the per-chunk dirty kick during mode 2026 sync frames\
• Write MCP-trust flag into isolated worktrees so agents don't re-prompt
  \

2.74.0\

June 20, 2026
\

• Launch the first hero by session identity, not name lookup\
• Honor the project's persisted active party for CLI quest start\
• Honor --model when summoning a solo hero shard
  \

2.73.1\

June 20, 2026
\

• Apply global hero customizations to solo summon
  \

2.73.0\

June 19, 2026
\

• Solo hero shards — summon a catalog specialist on its own\
• Keep manual selection alive during streamed output\
• Cmd+click to open any file path or URL
  \

2.72.0\

June 18, 2026
\

• Drop free-tier count caps — unlimited gems, shards, facets\
• Monospace the sidebar group headers\
• Inclusive, shorter page description\
• Swap settings columns — library left, slot buttons right\
• "Your prompts" → "Your facets"; subcopy names prompts + commands
  \

2.71.0\

June 18, 2026
\

• Translucent overlay scroller to match the glass panel\
• Anchor to the default sidebar + add a workbench step\
• Rename "backlog" to "workbench" (user/agent-facing, back-compatible)
  \

2.70.0\

June 18, 2026
\

• Add license + connect iphone to the app menu\
• Sync push opt-in with the real system permission\
• Suppress the push banner for the shard you're viewing\
• Apply notification deep link on cold launch / after pairing\
• Gate phone pairing behind Guild, show upgrade prompt\
• Richer quest party in demo mode (3 heroes, multi-hero thread)\
• Make the push opt-in card specific about phone notifications\
• Make email the expected default on bug reports\
• Tell agents to offer a reply email on bug reports\
• Fast-poll the transcript while the agent is working\
• Broadcast working/idle on hook edges so phone dots track all agents\
• Lowercase the crystl wordmark in the app menu copy\
• Suppress "live updates lost" banner in demo mode\
• Lock the app to portrait\
• Tell agents to interview + investigate before filing a bug report
  \

2.69.0\

June 17, 2026
\

• Quest button going dead after the setup panel is dismissed\
• Stop the ping burst when reopening a quest with history\
• In-panel "start fresh?" launch step with a back button\
• Keep setup panel open when editing in a child panel\
• Relaunch each hero's agent when resuming a quest
  \

2.68.0\

June 17, 2026
\

• Click-to-reveal description + sane new-item focus flow
  \

2.67.0\

June 16, 2026
\

• Add fanout worker protocol to PromptTemplates + settings page\
• Draggable gem reorder + marquee fix
  \

2.66.0\

June 16, 2026
\

• Move default spawn agent to top of left column + layout fixes\
• Wrap the default-agent description + clearer title/copy
  \

2.65.0\

June 16, 2026
\

• Hand focus back to the terminal after committing an edit\
• Hover states for the + new / + item / + section pills + backlog handle\
• Show which conversation you're in + color the DM list
  \

2.64.0\

June 16, 2026
\

• Keep the sender color when a message is clicked\
• Polish the chat sidebar — hover, channel order, DM hint\
• Keep the intro logo out of hero DM channels
  \

2.63.0\

June 16, 2026
\

• Extend the drawer to the full right column\
• Scroll the CRYSTL QUEST logo with the message flow\
• Rebuild terminal rows after a sidebar-mode toggle resize\
• Stop the screenshot bar sliding under the open drawer\
• Re-hide gem header when flipping out of Settings in tab-bar mode
  \

2.62.0\

June 16, 2026
\

• Launch agents on a task via shard create --agent/--prompt\
• Bind remote access on the flag alone, not the async license\
• Detect tunnel-port conflicts and add crystl ssh bridge-address\
• Apply per-hero model at quest start instead of clobbering it\
• Add settings toggle for the SSH preflight diagnostic\
• Warn in-terminal when remote agent notifications can't reach Crystl\
• Inject CLI/backlog snippet when picker reconfigures a gem in place\
• Guild upsell on the mobile settings toggles\
• Full-gate remote access on Guild license\
• Advertise quest, fs, open/close, askuser, facet in the CLI snippet\
• Autoscroll long gem titles on hover
  \

2.61.0\

June 16, 2026
\

• More breathing room above the CHAT HISTORY section\
• CHAT HISTORY header + explanation in setup panel\
• Roomier clear/start-fresh confirm with header + explanation\
• Preserve party roster across archive, don't lose definitions\
• Crystl quest start CLI command\
• POST /quest/start bridge route to launch a party headlessly\
• Crystl quest clear CLI + POST /quest/clear bridge route\
• Continue/start-fresh launch prompt + manual clear button\
• Archive-not-delete primitive for clearing chat history
  \

2.60.0\

June 15, 2026
\

• Claude's chat speaker tag in its brand orange\
• Chat tracks the agent's reply live, not on a 18s lag\
• Quest logo caption text style, fanfare off-main, accurate comment\
• /quest returns no messages when the quest is inactive\
• Push quest end on shard/gem close, not just explicit endQuest\
• Refresh gems only on quest membership change, not per message\
• Match desktop quest hero colors (was 3 purples)\
• Refresh the phone when a quest ends (stale conversation)\
• Tile the quest logo pixels + typewriter font on awaits screen\
• CRYSTL QUEST logo on the quest tab's "awaits" screen (was swords)\
• Phone registers a desktop-launched quest immediately (was ~8s)\
• Quest logo as a fit-to-width default screen, not a clipped flash\
• CRYSTL QUEST intro overlay on quest-chat open\
• Port the synthesized quest fanfare to iOS\
• Restore the launch intro (logo + fanfare) — join was posted too early\
• Persistent per-hero colors in the quest chat (match desktop)\
• Resolve Claude transcript by the file it's writing, not argv/mapping\
• Submit injected quest paste with a separate, delayed double-Enter\
• Delta-aware screen refresh in the shard VM (Phase 3)\
• Row-delta screen responses via ?base= (Phase 3)\
• Screen row-delta DTO + pure apply (Phase 3)\
• Push-driven shard refresh, drop the fast 1.5s screen poll\
• Emit unified, sequenced shard_update (screen + transcript)\
• Shard_update event DTO, gap helper, and stream/VM wiring\
• Resolve Claude transcript from argv, in front of the mapping\
• Expose a shard agent's process argv (AgentMonitor.agentArgs)\
• Terminal tab polls fast again (was lagging ~18s after the SSE work)\
• Don't serve the previous Claude session right after a summon\
• Brighten + "agent" badge on backlog tasks an agent touched\
• "+ item" opens the editor — add title + description in one step\
• Backlog section header rename + delete via context menu\
• Backlog section rename + delete plumbing\
• Backlog section rename + delete routes\
• Delete a section header on desktop (tasks survive)\
• "+ section" no longer discards its draft instantly (desktop)\
• /send writes Enter twice so a busy TUI doesn't drop it\
• Mobile sticky "+ item / + section" add bar\
• Desktop sticky "+ item / + section" add bar\
• Bridge POST /backlog/section route\
• CrystlKit empty-section path (addBacklogSection)\
• Inline "+ section" affordance + click-to-rename headers\
• BacklogStore.renameSection(at:to:)\
• "＋ section" button on the drawer instead of typing ##\
• Create sections from the desktop drawer (## syntax)\
• Tap a backlog task to edit its title + description\
• Backlog tab to parity — multi-line detail, 3-state cycle, section picker\
• Keyboard no longer covers the backlog add-task field\
• Fall back to newest session when Claude's mapped one is a phantom\
• Pull-to-refresh re-dials the connection, not just re-fetches\
• Backlog as a 3rd tab — content API + live editable list\
• Pin hookless agent sessions per shard so shared-cwd shards don't collide\
• Up-front Guild affordance — disable mutating controls when !canMutate\
• Push agent_status_changed over SSE; fold status into screen/transcript
  \

2.59.0\

June 14, 2026
\

• Group sidebar nav under section headers\
• Agent-change badge + longer flash\
• Settings on/off + auto-open on new items\
• Crystl backlog open/close/toggle\
• Flash on detail edits, indent grip, align open count\
• [~] in-progress task state + change-flash\
• Retry transient relay failures with backoff\
• Clarify crystl docs id-vs-search header comment\
• Match window background, side/down carrots, drag-to-reorder\
• Crystl-aware agents — crystl docs + crystl report\
• Crystl facet — manage facet inserts + bar slots
  \

2.58.0\

June 14, 2026
\

• Create CLAUDE.md + AGENTS.md when a project has no agent doc\
• Tell agents about the backlog + history; broaden agent coverage\
• Editable per-gem backlog in a right-edge slide-out drawer\
• Run command inserts via Claude bash mode (! prefix)\
• Tag inserts as cmd or prmt, show pill in bar dropdown\
• Re-dial the tunnel on system wake and network changes\
• Add heartbeat ping/pong to detect dead tunnels\
• Don't let a transient hello_err kill the tunnel forever
  \

2.57.0\

June 13, 2026
\

• Lead the heroes column with a Hero System / hero stats key entry\
• Honor local heroes' explicit hero name with collision handling\
• Local-heroes picker + guardrail tagging in setup panel (Phase 2)\
• Project-local guardrail heroes from .crystl/heroes/\
• Per-gem auto-approve picker writes the dir the bridge reads
  \

2.56.0\

June 13, 2026
\

• White labels for Codex plugin/skill rows (were black)\
• Gap between troubleshooting blurb and the copy button\
• Tighten captions under the field + button on Remote page\
• Drop redundant toggle blurb; 'your Mac's bridge'\
• Restructure Remote page — neutral lead, troubleshooting section, help icon placement\
• Lead the Remote page with its use case\
• Clearer remote-install button + copied flash\
• Dedicated Remote page; move SSH out of Claude\
• Resume uses the hero's configured agent, not hardcoded claude\
• Keep quest verbs on PATH when an agent session resumes\
• Clearer dropdown affordance on facet pills
  \

2.55.0\

June 12, 2026
\

• Isolated shards are now hard-blocked from editing files outside their own worktree — an agent in an isolated shard can no longer accidentally modify the main checkout\
• More reliable hooks: approval prompts and side-quest messages now authenticate correctly over the local unix socket (no more silent 403s)
  \

2.54.0\

June 12, 2026
\

• Include bridge port on the unix-socket message path\
• Send bearer token on the unix-socket hook path\
• Hero editor model is free-text for every agent, not a Claude-only dropdown\
• Quest open panel shows each hero's agent + an edit pencil; drop 'Requires Claude Code'\
• Codex turn metrics — parse rollout JSONL for the turns panel\
• Turns panel recognizes Fable (1M) and stops mislabeling unknown models as Sonnet
  \

2.53.0\

June 12, 2026
\

• Never symlink tracked config files into worktrees\
• One agent-badge convention across all agents in panel headlines\
• Badge non-Claude agents in panel headlines next to the shard name\
• Summon keeps hero-editor agent choice over party-blob default\
• Agent-aware resume gate + quest fallbacks\
• Quest launch path resolves the hero's agent via AgentLaunchSpec\
• Agent picker in quest hero editor\
• Per-hero agent field on QuestRole + questAgents persistence\
• AgentLaunchSpec — per-agent quest launch table keyed by AgentKind\
• Codex hook adapter — approval panels + notifications via codex hooks\
• Thread agent identity through bridge + panel headlines\
• Add optional agent identity field to PendingRequest + HookNotification\
• Antigravity CLI transcript backend — SQLite + protobuf walk\
• Detect Google Antigravity CLI (agy)\
• Codex/gemini session view + waiting-prompt detection\
• Session view is the default for every shard\
• Task cancellation is benign, not 'Network error: cancelled'\
• Line-drawn Lucide tab icons for approvals + questions\
• Welcome screen fits whole — auto content-width fit in session embed\
• Flip the session-store split — Crystl takes the new filename\
• Identity-split Stone vs Crystl session mappings\
• Splash glow stays on the track, ping-pongs instead of snapping\
• Splash progress glow in brand icy blue (accent), not peach\
• SessionStart hook remaps shard→session immediately\
• Session view lands at the bottom, capped to the last 200 rows\
• Persistent CI signing identity via repo secrets\
• Archive with the cloud Distribution cert, not per-run dev certs\
• Session view shows live terminal until the conversation starts\
• Agent-working pulse on gems page\
• Auto-trust pre-existing project MCP servers on gem open\
• Detect agent stalled on hook-less TUI prompts, notify + push\
• Splash progress — slow blush glow instead of orange dot\
• Reset relay route memory on foreground\
• Pair-device relay toggle + AppDelegate RelayClient wiring\
• RelayClient — WS tunnel, loopback replay, reconnect\
• MacId + macSecret identity provisioning\
• Swift frame codec for the relay wire contract\
• Persist relay endpoint with the pairing\
• LAN→relay per-request fallback with session route memory\
• Pairing payload v2 — relay + mac_id\
• Route-aware endpoint requests\
• Tap-to-talk mic button in the send bar\
• Branded launch splash — glowing crystal, serif wordmark, progress line\
• Terminal pinch-zoom + fit double-tap; agent-less shards open on terminal
  \

2.52.0\

June 11, 2026
\

• Report-bug link in the Help menu\
• Match the open-button shine to the quest button\
• Loop the open-button shine until the user moves on\
• Shimmer the open button to cue a selected folder
  \

2.51.2\

June 10, 2026
\

• Treat checksum-less party.json as managed, not frozen
  \

2.51.1\

June 10, 2026
\

• Restore DMs channel list opacity so it renders when shown
  \

2.51.0\

June 9, 2026
\

• Fade gem rows at scroll edges instead of a shadow overlay\
• Keep AskUserQuestion panels until answered\
• Glow halo on the unconfigured folder icon\
• Recursive folder search, path typing, and open button
  \

2.50.0\

June 9, 2026
\

• Recolor letter-icon preview when the color changes\
• Make the PROJECT DIRECTORY field typeable\
• Stop gated-quest warning from overlapping the requires note\
• Quest panel reads party roster from resolver\
• Warn when a hand-edited party.json is undecodable\
• Never regenerate a hand-edited party.json\
• Resolve party roster from user-owned party.json\
• Decode v2 party.json into QuestParty\
• Managed party.json writer + ownership checksum\
• Load saved hero stats on editor reopen\
• Strip OSC 7 file:// URI from session cwd
  \

2.49.0\

June 8, 2026
\

• API transcript handler uses per-agent TranscriptSource\
• Drive the navigator panel through TranscriptSource\
• RemoteFileAccess SSH backend for transcript sources\
• Gemini session resolution (registry + legacy hash)\
• Gemini chat parser (user/gemini → events)\
• Recognize Google Gemini CLI as an AgentKind\
• Codex session resolution by session_meta cwd\
• Codex rollout parser (response_item → events)\
• TranscriptSource protocol + factory + ClaudeTranscriptSource\
• Add TranscriptFileAccess protocol + LocalFileAccess\
• Auto-publish appcast to crystl-web + deploy
  \

2.48.0\

June 8, 2026
\

• Default to sidebar mode + redesigned two-row header\
• Empty/remote rail states, remove dead picker/scrollback code\
• Search field + results across the gem's sessions\
• Auto-open the active shard's session\
• Highlight the rail moment matching scroll position\
• Moment↔scroll index and jump-to-moment in the right pane\
• Rail moments state with back navigation\
• Rail session-list state (replaces scrollback list)\
• Clamp the panel on-screen so the larger 660x520 panel stays visible\
• Add background gem-wide search driver\
• Add per-session unified search (conversation + tools)\
• Add moment extraction for the navigator rail\
• Hide picker rule on Scrollback, picker tooltips, row hover\
• Taller panel, top-align scrollback, clickable rows\
• Stop main-thread freeze when opening the history panel\
• Validate transcript sessionId to block path traversal\
• Empty-states (remote/Codex), picker visibility, polish\
• Add Conversation + Tools transcript tabs with session picker\
• Convert HistoryPanel to tabbed shell with Scrollback tab + clear control\
• Append session-log record on each save\
• Add append-only claude-session-log for shard tagging\
• Add SessionHistory.clearOlderThan(days:)\
• Add SessionHistory.clearAll for scrollback cleanup\
• Add crystl history CLI command\
• Fetch remote transcripts over SSH for the transcript route\
• Serve GET /gems/:id/shards/:sid/transcript (local)\
• Add TranscriptRow/TranscriptResponse wire types\
• Load + list transcripts from a bucket dir\
• Parse flat JSONL transcript with tool pairing\
• Derive per-tool summary one-liners\
• Add transcript bucket-path encoding\
• Add TranscriptEvent model for Claude transcript parsing
  \

2.47.2\

June 7, 2026
\

• Log the two silent /hook drop points (401 + external-session filter)
  \

2.47.1\

June 7, 2026
\

• Log when a notification is dropped by the per-type enabled gate
  \

2.47.0\

June 7, 2026
\

• Tolerate create-dmg AppleScript styling failure\
• Target the bridge that spawned the shard, not the newest token file\
• Make crystl approve/deny report whether a request resolved\
• Detect uncommitted worktree work instead of silent nothingToMerge\
• Make smart auto-approve in-scope work (F3)
  \

2.46.1\

June 7, 2026
\

• Stop bar at sidebar divider + fade overflow edges
  \

2.46.0\

June 7, 2026
\

• Insist workers report DONE/BLOCKED as a required final action\
• Gate control commands behind Guild (read-free, control-gated)\
• Suppress approval/notification panels for orchestrator-managed workers\
• Decode crystl pending without snake_case conversion\
• Pre-trust the canonical (symlink-resolved) worktree path\
• /fanout orchestration command + auto-provisioning on launch\
• Pre-trust worker worktree so it runs unattended\
• Reject malformed quest_msg without polluting the channel\
• Clarify context-window step copy\
• Add project optimizer step opening the ⋮ menu\
• Retarget gem settings step at the ⋮ menu\
• Pin CRYSTL_QUEST_ROOT so --approval+--quest workers write to gem root\
• Reject remote isolated shards instead of mis-merging locally\
• --quest installs fanout comms channel at shard spawn\
• Crystl merge command for isolated shards\
• --approval at shard spawn\
• Scope log dir by AppIdentity.name so Stone stops writing into Crystl's
  \

2.45.0\

June 6, 2026
\

• Add optimize item to gem ⋮ menu\
• Optimizer header shows large gem name + icon
  \

2.44.0\

June 6, 2026
\

• Mirror gem ⋮ menu + hover close on sidebar gem rows\
• Gem-tab ⋮ menu (history/settings/approval); remove GemToolbar pill\
• add TabControlGeometry helper for gem-tab hover controls
  \

2.43.0\

June 6, 2026
\

• Address pre-ship review (resize-safe disable, hover band-gate, observer cleanup)\
• Settings icon uses a native tooltip instead of a clipped hover label\
• Move settings icon inward so its hover label isn't clipped\
• refine sidebar: align SHARDS with shard text, label footer + new gem\
• Don't reveal the tab bar over the sidebar after leaving settings\
• refine settings: more space below APPEARANCE/BEHAVIOR headers\
• refine settings: more header space, independent columns, squarer diagrams\
• Two-column general settings + sidebar-mode illustration\
• Larger gem sidebar rows (14pt names, 18px icons)\
• refine sidebar: align SHARDS with GEMS, wider bar, larger gems, more gutter\
• Stacked two-row shards bar in sidebar mode\
• Optional stacked two-row layout for SessionBarView\
• refine sidebar layout: terminal gutter + shards bar aligned with gems header\
• refine gem sidebar: drop redundant open-folder button, improve spacing\
• Add sidebar-mode settings toggle\
• Sync gem sidebar from updateTabBar\
• Wire gem sidebar into window layout with window growth\
• GemSidebarView vertical scrollable gem list\
• GemRowView for sidebar gem list\
• Sidebar-mode window geometry helper
  \

2.42.6\

June 5, 2026
\

• Submit injected paste under kitty mode without report-all-keys
  \

2.42.5\

June 4, 2026
\

• The context button shows the live turns-left count again. The recent rework had reduced it to a plain "turns" label; the "~N turns left" estimate is back on the button (auto-sized so large counts don't clip) and updates each turn.
  \

2.42.4\

June 4, 2026
\

• Drag-to-select now auto-scrolls. Pull the cursor to the top or bottom edge while selecting and the terminal scrolls so you can select more than a screenful. Holding at the edge keeps scrolling, releasing stops it.\
• Fixed scrollback getting stuck in some sessions. When an app enabled mouse reporting it was eating the scroll wheel even in the normal buffer, so you couldn't scroll back through output. The wheel is now only handed to full-screen apps (tmux/vim); otherwise it scrolls your history.\
• "Agent finished" notifications show by default. Subagent completions are now treated the same as the main agent finishing, instead of being off until you opted in.\
• Fixed notifications overlapping the Crystal Rail. After dragging the rail from a side to the top, floating notifications now re-align below it without needing to be dismissed first.
  \

2.42.3\

June 4, 2026
\

• Notifications now come through for Claude running over SSH. Idle prompts and questions from a remote session were being silently dropped, and only locally-run agents surfaced panels. Remote sessions now raise the same idle, question, and subagent notifications as local ones, while non-crystl agents in other local terminals stay filtered out.
  \

2.42.2\

June 3, 2026
\

• Auto-approve now follows the project you're working in. When a shard worked inside a project nested under a broader gem (e.g. a home-folder gem), the gem's approval mode could shadow the project's, so a project set to "all" still prompted for every tool. Approval mode is now resolved from the working directory first, and the rail's approval picker reflects the mode that's actually in effect.
  \

2.42.1\

June 3, 2026
\

• Formations keep your gem names again. Renaming a gem in Gem Settings now sticks when you save it into a formation. Previously the gem came back with its folder name instead of the name you gave it. (Formations saved before this fix need one re-save to pick the names back up.)
  \

2.42.0\

June 3, 2026
\

• Context "turns left" estimate fixed for large-window models. It now reads the real context window for newer models (e.g. Opus 4.8's 1M window) instead of assuming 200K, so the countdown is realistic instead of hitting 0 about five times too early.\
• The context button is always available. It appears as soon as an agent is running (labeled "turns" with a subtle button border) and opens even before the first turn lands so you can still see the fixed-cost breakdown.\
• Redesigned the context panel header. A larger "token usage · gem · shard" title with the gem's icon inline, and the model and window size on the line below.\
• The per-turn cost list scrolls. Setups with lots of plugins and skills no longer push the panel off-screen; the column headers and total stay pinned.\
• Plugin and skill rows are clearly clickable. They highlight on hover and pop their menu on a click anywhere along the row.
  \

2.41.0\

June 3, 2026
\

• Subagents are identified in panels. Each gets a stable dwarf name, a pickaxe glyph, and a "sub · " line on both approval cards and notifications, so parallel subagent activity is easy to tell apart.\
• Notifications stack. A deck-style peek instead of being dropped once more than four arrive.\
• Redesigned the Gem Settings / New Gem panel into Identity and Agents tabs, never runs off-screen, with a ROOT FILES drawer and consistent spacing.\
• Codex plugins & skills moved to the Codex settings page (they're global, not per-gem); the gem panel now links there.\
• New-gem "initialize git" and remote URL moved to the Identity tab.\
• Fixed Crystal Rail badge clipping.
  \

2.40.0\

June 2, 2026
\

• Master ENABLE toggles in Gem Settings. The plugin, skill, and MCP sections each get a top-level enable toggle.\
• Fixed a stray "Butt" label leaking onto icon-only buttons (the NSButton default title).\
• Update-check ping includes license plan (free / pro) so anonymous free devices are labeled.
  \

2.39.0\

May 30, 2026
\

• Plugin recommendation catalog grew from 5 to 23. The optimizer now recognizes 18 more Claude Code plugins when their detection signal fires, covering databases / backends (Firebase, MongoDB, Neon, PlanetScale, Convex, Appwrite), auth (Auth0, WorkOS), frontend / framework (Expo, Apollo GraphQL, Sanity, Shopify, Mintlify), email / messaging (Resend, Twilio), observability (PostHog, Datadog), and Netlify for deploys. Detection is the same shape as before: manifest file (firebase.json, netlify.toml, convex.json, etc.) or a package.json dep prefix (@neondatabase/, mongoose, @auth0/, etc.). When a match fires and the plugin isn't installed, the optimizer's setup section shows + install <plugin>; one click types /plugin install <id> into the gem's selected shard.
  \

2.38.0\

May 30, 2026
\

• Optimizer recommends Claude Code plugins. Open the optimizer in a Vercel / Supabase / Cloudflare / Sentry / Stripe project (detected via vercel.json, wrangler.toml, @vercel/* / @supabase/* / @sentry/* / stripe deps, etc.) and the setup section shows a one-click + install <plugin> row. Clicking it types /plugin install <id> into the gem's selected shard, then watches ~/.claude/plugins/installed_plugins.json for 30s and auto-rescans so the gap disappears once install completes. If the plugin is already installed but disabled for that gem (via the context-load panel right-click), you get + re-enable <plugin> instead, one click strips the disable entry from .claude/settings.json. The catalog ships as Resources/plugin-recommendations.json so adding new plugins is a JSON commit, no Swift edit.\
• Astro project detection. Projects with an astro.config.mjs (or .ts / .js) now get an "Astro project" profile in the optimizer instead of falling back to generic Node.js with linter / logging nudges.\
• Optimizer setup checks are scoped clearly. The setup-tab rows now read "No X in this directory" so it's obvious the optimizer grades the gem's onboarding, not your global Claude config. The misnamed "Claude skills" check (which was actually testing .claude/commands/) is now correctly labeled "slash commands," and a real .claude/skills/ check was added alongside it.\
• Gem Settings: Claude/Codex label parity. Claude accordion sections now read "INCLUDE CLAUDE SKILLS?" / "INCLUDE CLAUDE PLUGINS?" matching the Codex labels, less ambiguous in mixed-agent gems.\
• Context-load panel refreshes in place. Disabling or re-enabling a plugin/skill from the turns panel now updates the strikethrough row and totals immediately. Previously you had to close and reopen the panel to see the change.
  \

2.37.0\

May 24, 2026
\

• crystl CLI. A crystl command-line tool ships inside the app bundle. Install via Help → install command line tool… (one admin prompt, symlinks /usr/local/bin/crystl) or from Settings → General → Command Line Tool. From any terminal: crystl gems, crystl shards --gem <name>, crystl screen, crystl send, crystl pending, crystl approve / deny. Full reference at crystl.dev/docs/cli.\
• New CLI commands.crystl shard create --gem <name> [--isolated] [-c "<cmd>"] spawns a sibling shard so orchestrator agents can fan out parallel work. crystl events streams the bridge's SSE event log as JSON lines, pipe-friendly with jq. crystl wait pending blocks until a permission request appears, built on SSE, no polling.\
• Agents discover the CLI automatically. Each gem's CLAUDE.md and AGENTS.md get a short marker-bracketed Crystl CLI section upserted on open, so any agent inside a crystl shard knows it can coordinate with sibling shards. Idempotent (re-runs upsert in place), only touches files that already exist, gated by a General settings toggle.\
• CLI fixes from first round of testing.crystl open now reports Path does not exist / Path is not a directory instead of a generic failure. crystl close accepts gem name (was UUID-only despite the help text). crystl screen trims trailing NULs so grep stops silently exiting 1 on the output. crystl send appends \r by default so commands submit in shells and TUIs (Claude Code, vim); use --no-enter to opt out.
  \

2.36.37\

May 22, 2026
\

• Stale panels auto-dismiss. Ask-user, approval, and notification cards now disappear when the agent moves on, rather than sitting orphaned until you click. New rules cover SessionEnd (drops everything pending for that session), PostToolUse matching an open approval (the tool already ran), a shard restarting its agent (different Claude session_id for the same shard UUID), and the big one, any follow-up hook for a session with an open question proves the agent moved past it without your panel's answer. The 5-minute hard timeout stays as a backstop.\
• Notification cards finally auto-dismiss. The dismiss timer slot existed but was never populated, so informational cards stacked indefinitely. Now they fade after 8 seconds by default, question cards still persist until you click Answer or Dismiss. Tunable via the notificationAutoDismissSeconds UserDefault (set to 0 to disable).\
• CrystalRail polish. The tile strip now scrolls when it exceeds 80% of the screen instead of overflowing off the edge. Fixed the top of the rail disappearing after closing a gem from the middle of the strip.
  \

2.36.36\

May 21, 2026
\

• General settings polish. The allow notifications from other terminals toggle now carries a caption explaining what it does ("allows crystl rail to display agent notifications from other terminals"), and the toggle label gains a leading verb so the action is unambiguous. Fixes layout overlap in Settings → General: the SESSION RESTORE section header no longer collides with the restore last session on startup toggle pill, and the GPU rendering / external-notifications subcopy hints no longer crowd the toggle below them.
  \

2.36.35\

May 21, 2026
\

• Notification isolation for other terminals. Claude invocations running outside crystl (Terminal.app, iTerm, Warp, Ghostty, tmux, a cron job, anything) no longer surface in crystl's rail by default. New notifications from other terminals toggle in Settings → General flips the behavior back on per machine. SSH-tunneled and Tailscale/LAN sessions are unaffected and keep working regardless of the toggle, since remote Claude can't supply crystl's session env vars. Also fixes a clobbering bug when two builds were installed side by side: the shared ~/.claude/crystl-hook.sh would route hooks to whichever installed last; each build's spawned shells now stamp the bridge port, socket, and token-file path into env so the script reaches the right bridge.
  \

2.36.34\

May 21, 2026
\

• Tab and context-bar polish. Long gem-tab titles no longer crash into the close ×: the glyph is 10% smaller and sits 8px from the tab's right edge (was 12), with a real 6px gap before the text clip. The ~N turns left indicator in the status bar now brightens from alpha 0.5 to 1.0 on hover so its clickability is obvious instead of reading as a static label. The welcome tour adds a 13th step explaining the context-window indicator and what it points to. The real button only appears after three turns, so the tour materialises a mock at the same position during the step.
  \

2.36.33\

May 21, 2026
\

• See and shrink the plugin / skill context load per gem. The ~N turns left panel now itemizes every installed Claude Code plugin and user-level skill alongside CLAUDE.md / AGENTS.md / .mcp.json. Each row shows lines, tokens, and % of window. Left-click any plugin or skill row to disable it for the active gem, for all gems, or (for Codex) globally; disabled rows render grayed with a strikethrough and a one-click re-enable action. Claude disables write .claude/settings.json and inject /reload-plugins into the active shard so changes apply mid-session; Codex disables write ~/.codex/config.toml with a "restart codex to apply" note since Codex has no per-project scope. Plugin and skill checkboxes also appear in the New Gem and Gem Settings panel as collapsible INCLUDE PLUGINS? / INCLUDE SKILLS? sections, plus INCLUDE CODEX PLUGINS? (global, restart codex) for Codex. New gems with a recognized stack (Vercel, Shopify, Cloudflare, Supabase, Sentry, Swift) get an opt-in dialog proposing which plugins to enable / disable. Bug fix: the turns-remaining button now appears reliably after three turns even when agent detection is mid-cycle.
  \

2.36.32\

May 20, 2026
\

• Welcome tour: 12 steps, follows the window, replays from Help. The first-run tour now covers isolated shards, quest / side quest, the screenshots bar (it opens automatically during its step), and ends on a centered farewell with a one-click join slack CTA. Bubbles attach as child windows so they track parent moves through drag, fullscreen, and screen-to-screen jumps. Chevrons now land on the actual control they describe (the +, the isolation dropdown, the quest button, the facet pills) instead of the wide bar’s midpoint. Crystal rail step mentions drag-to-dock on the left, right, or top edge. App settings step calls out the trio that actually matters: API keys, MCP servers, and CLAUDE.md / AGENTS.md editing. New Help → show welcome tour menu item replays it on demand.
  \

2.36.31\

May 19, 2026
\

• Notifications: timestamps on the headline. Notification cards now show when they were created, diamond notification - just now for fresh cards, switching to absolute time (diamond notification - 7:35pm) at the 60-second mark via a one-shot per-panel timer. Lets you tell at a glance whether a long-lived notification is current or stale instead of having to dismiss-and-wait-for-the-next-one.\
• Shards: stop nagging on every shared shard in home-rooted gems. The home-directory warning was firing on every shared-shard creation, not just isolated attempts, far too noisy for users who intentionally have a home gem. Isolated shards in home still refuse loudly (they’d scatter worktrees under ~/.crystl/), but shared shards now create silently.
  \

2.36.30\

May 17, 2026
\

• Invisible-text-on-glass: defensive widening on PTY data. The known “text gone, drag-select makes it appear and stay” signature recurred. Classic renderer-side bug where SwiftTerm’s per-row dirty marking missed a buffer update under heavy Claude Code output, so the renderer’s row cache kept serving stale bytes. Selection works because selectionChanged widens metalDirtyRange to the full visible range. Mirrored that widening into the existing dataReceived kick via a new crystlMarkVisibleDirty() patched onto SwiftTerm. Every PTY chunk now guarantees the next Metal draw rebuilds visible rows from current buffer bytes. Belt-and-suspenders on top of the metalDirtyRange union patch: that one fixes writer-vs-writer clobbering; this one defends against writers that miss rows entirely.
  \

2.36.29\

May 17, 2026
\

• Syntax-highlighted type tokens readable on glass. Claude Code’s Monokai Extended theme emits lone \e[2m...\e[22m for both ghost-text hints AND code-block type tokens (UInt8, ArraySlice, etc). The SGR rewriter was injecting gray-120 as the lone-dim substitute, visible enough for input-bar placeholders, but invisible-dark on glass for code-block types that use the same bytes. Bumped to gray-180 so both render visible-but-distinctly-dim relative to typed input (which lifts to white).\
• Renderer fg luminance floor catches tinted greys. The SwiftTerm-side floor only lifted pure greys (channel diff < 30) to white, lightly-tinted muted syntax-theme colors at diff 40 to 70 slipped past and rendered invisibly. Widened to diff < 80; saturated theme accents (diff > 100) still pass through unchanged.\
• Tab bar: clear gap between × close and + add buttons. With tabSpacing=2, the “+” was rendering essentially flush against the trailing tab’s “×”. Bumped the “+” offset so there’s a 10px clear gap.\
• Session bar: inset quest/isolation buttons 28px from right edge. The right-edge inset was 14px, crowding the close-window chrome. Centralised the margin in a constant and bumped to 28.\
• Crystal Rail: settings diamond back inside the glass capsule. The May 6 wrapper restructure (which correctly stopped alpha cascading from dimming tile icons) inadvertently floated the settings diamond above the rail with a visible gap. Returned just the settings icon to glass, tiles still sit outside glass so their alpha doesn’t cascade.
  \

2.36.28\

May 16, 2026
\

• Alpha floor: three small text/icon sites lifted from 0.4 → 0.5. crystl’s text alpha floor is “no text in the app should be less than white alpha 0.5”. Three sites still violated it: the QuestPanel subtitle (the · separator and gem name), the DirectoryPicker file icon color, and the TemplateLibraryPanel label badge. Visual polish only, minor brightening of subtle UI affordances against the dark glass background.
  \

2.36.27\

May 16, 2026
\

• Quest prompt restructured: comms rule first, explicit negative, concrete example. Real-quest feedback from a ranger shard that replied to the user with plain text instead of going through quest_msg. Asked the shard what would have made the rule stick, then applied its three suggestions verbatim: (1) moved the comms rule to the top (was buried mid-block after recon instructions); (2) added an explicit negative (was “use quest_msg”, now “NEVER respond to the user with plain text” with the consequence (“plain-text replies are invisible to the user”); (3) added a 4-step concrete example of what a first response should look like, because examples beat descriptions when there are 20 competing rules. Also broke the wall-of-text into section headers so the model can scan structure rather than parsing one long paragraph.
  \

2.36.26\

May 16, 2026
\

• “No conversation found” on startup, actually fixed this time. The v2.36.24 check rejected resumes when Claude Code had deleted the conversation file entirely, but missed the case where the file exists in a *different* cwd’s project bucket. That’s what was happening on most affected sessions: a shard was originally cd’d into one directory when its Claude session was saved (say ~/Nextcloud/promptreviews), then the gem’s resolved cwd changed (back to ~). The conversation file lives in the original cwd’s bucket but claude --resume <id> from the new cwd only looks in the new cwd’s bucket. crystl now encodes the path the same way Claude Code does (each / → -) and checks the one specific bucket the autorun script will actually run from. Mismatch → no autorun written → clean prompt.
  \

2.36.25\

May 16, 2026
\

• Quest messages now actually reach the agents when multiple gems share a path prefix.bestProject(for:) had a longest-wins tiebreak that picked the wrong gem when two gems both overlapped the query cwd, specifically when one gem was AT the cwd and another was nested deeper. Quest delivery then iterated the deeper gem’s sessions, found no quest shards (the quest was in the shallower gem), and silently skipped the message. Symptom: chat panel UI showed your typed message, but agents never received it. Fix: prefer exact match first, then deepest-cwd-contained, then SHALLOWEST-gem-inside-cwd so a gem AT the cwd wins. Also tightens prefix comparisons to require the path separator so /Users/chris doesn’t spuriously match /Users/chrissomething.
  \

2.36.24\

May 16, 2026
\

• No more “No conversation found with session ID” error on startup. When crystl restores a shard via session resurrection, it writes .crystl/autorun-<shard>.sh containing claude --resume <id>, which the shell sources at prompt start. If Claude Code has deleted the conversation file in the meantime (rotation, cleanup, sync drift), the resume command printed a red error to the terminal on every startup until the user did something. Now crystl checks that the conversation file actually exists at ~/.claude/projects/*/<id>.jsonl before writing the autorun, no file means no autorun, which means a clean prompt. The saved session ID is left in .crystl/claude-sessions.json so a later restoration (backup, sync) will resume cleanly on the next startup.
  \

2.36.23\

May 16, 2026
\

• Fresh “begin quest” summon now actually opens the chat panel. Same class of bug as the v2.36.19 resume fix, and previously masked the same way. The fresh-summon path had a timing race: injectQuestWrapper (which set hasQuestContext = true) was scheduled for +0.8s after shard creation, but the chat-panel open ran at +0.2s. The chat-open path checks hasQuestContext to decide whether to construct the panel and silently no-opped because the wrapper hadn’t fired yet. Fix: set hasQuestContext synchronously when the shard is created. The flag represents intent (“this is a quest shard”), not “the wrapper scripts are installed.” Reproducible on a 1-hero party; party size didn’t affect the race.\
• QuestReportGenerator: empty-string check instead of nil-coalesce. Compile-time warning cleanup, session.detectedModelId is non-optional so ?? “unknown” was dead code. Switched to .isEmpty which correctly expresses the “fall back when no model detected” intent.
  \

2.36.22\

May 16, 2026
\

• Shard label readability: luminance floor + dropped onyx. Some shard pills had crystal colors dark enough to be hard to read on the glass background: lapis, ruby, garnet, cobalt, and tanzanite were the worst offenders. New NSColor.shardReadable() helper applies a perceived-luminance floor (BT.709 Y ≥ 0.55) at the draw site, multiplicatively scaling channels to preserve hue while lifting darks. Onyx removed from the crystal rotation: it was grey-dark by design and just converged to a generic medium grey after the floor. New auto-allocate order: diamond → opal → jade → lapis → topaz → pearl → amber → quartz → ruby → garnet → emerald → cobalt → peridot → zircon → amethyst → tanzanite → carnelian → turquoise → morganite (19 names). Existing crystl/onyx worktree branches on disk still appear in the Isolation dropdown as orphans and can be reopened.
  \

2.36.21\

May 16, 2026
\

• PTY hot-path: cached UserDefaults reads + MTKView subview reference.dataReceived fires per chunk of bytes from the agent, 50 to 200×/sec under Claude output. The two diagnostic kill switches (crystlDisableSGRRewriter, crystlDebugBytes) now read once at first reference instead of per chunk, and the MTKView subview is resolved lazily once and cached instead of walked + class-name-substring-matched per chunk. Both flags now require an app restart to take effect.\
• Pulse animations: shared 20Hz clock, cached questEnabled, alpha-at-draw. Three independent per-view Timer.scheduledTimers consolidated into one shared AgentPulseClock, previously 11+ independent timers under a multi-gem multi-shard quest. Bonus: all pulsing surfaces now lock-step instead of drifting in/out. Cached questEnabled in SessionBarView. Fixed a silent bug where the pulse alpha on shard-bar icons was being dropped before reaching the screen (visible behavior change: the git-branch and swords icons now actually pulse / hover-brighten).\
• UI hot path: async git scans, memoized window title, async file gather. The local GitWorktree.orphanedBranches call in refreshOrphanedWorktrees moved off main (panel-open path kept synchronous so the badge count is correct on first frame). ChamberSetupPanel’s orphan scan cached so typing in the path field doesn’t re-run git for-each-ref per keystroke. uploadV2StateToRemoteHosts’s file-gather phase moved into the async block. updateWindowTitle() memoized to early-bail on no-op title rebuilds.\
• Lifecycle cleanups.DirectoryPicker’s NotificationCenter observer now removed before re-assignment and in deinit. Previously a re-shown picker leaked the prior observer which then fired on every settings keypress (visible as settings UI sluggishness). AppDelegate’s Enter-key NSEvent monitor token now stored + removed at app termination. Three AppDelegate+Formations``usleep polling loops replaced with chained DispatchQueue.asyncAfter, which no longer pins worker threads at startup with big formations.
  \

2.36.20\

May 16, 2026
\

• Subprocess deadlock when git or ssh output exceeds 64 KB.GitWorktree.run, RemoteSession.run, and QuestReportGenerator.collectFilesChanged all called readDataToEndOfFile() AFTER waitUntilExit(). macOS pipe buffers cap at ~64 KB, once a subprocess emitted more than that, the child blocked writing to the pipe while the parent blocked waiting for the child to exit. Classic deadlock; crystl would hang and the parent’s file descriptors leaked until force-quit. Triggered by git diff --stat HEAD on a big-changelist repo, git log on long history, ssh command output past 64 KB. Fixed all three sites with concurrent pipe drains via DispatchGroup before waitUntilExit.\
• Title hook: dropped the process-tree scan and heavy state writes. Companion fix to v2.36.18’s orphan-scan-off-title work. Every OSC title update from the agent was still triggering agentMonitor?.scanNow() (a full sysctl(KERN_PROC_ALL) walk) and updateAgentUI()’s file I/O (status.json, per-shard quest writers, healer alert scan, remote SSH upload). None of that data changes because of a title string, it changes on bridge hooks. Split updateAgentUI into a cheap UI-sync version and a new refreshAgentState() for the heavy work; bridge hook handlers now call the heavy version explicitly while the title hot path stays cheap.
  \

2.36.19\

May 16, 2026
\

• Quest “resume” button now actually opens the chat and delivers messages to agents. After a crystl restart, clicking the green resume (N shards) button in the quest setup panel would re-attach the worktrees but the chat panel never appeared. Once the chat was opened by other means and a message was typed, the message appeared in the panel UI but never reached the agent terminals. Root cause: resummonShards called openExistingWorktree (which creates plain isolated shards) but never installed the quest wrapper, so the resumed shards lacked hasQuestContext, which the chat-open path and the message-delivery path both gate on. Wrapper installation now runs on resume at the same cadence as on initial party summon.
  \

2.36.18\

May 15, 2026
\

• Typing lag during Claude activity fixed. The terminal-title hook was spawning 3 to 5 git subprocesses on every OSC title update from the agent. Claude Code emits title updates many times per second while “thinking”, so the main thread was starved of keyboard input the entire time the git scan ran. setTerminalTitle closure dropped from 43.5% to 3.1% of main-thread time after the fix; the cascade also cut CA::Transaction::commit from 61.9% to 45.6% and view backing-layer display from 49.7% to 27.6% (fewer spurious git scans = fewer cascading UI invalidations). Orphan-branch scan now happens only on events that can actually change the orphan set: gem switch, shard create/close/merge, and right before the isolation dropdown opens.\
• Welcome banner now dismisses on your next command. First-launch banner wipes itself when you run anything in the shell, no more lingering banner under your prompt. Hooks into the shell’s preexec via OSC 7770.\
• Fixed a regression where holding the delete key could leave stale glyphs on screen. The forced-repaint kick on PTY data had been removed in a recent change based on an A/B that showed “no regression”, but the test was conducted while another bug was incidentally refreshing the terminal layer as a side effect. Once that bug was fixed (above), the latent invisible-text regression surfaced. Kick restored.
  \

2.36.17\

May 15, 2026
\

• Cwd-drift warnings when a shard wanders outside its gem. A user who cd’s from inside gem A into project B’s directory sees their shell happily working in B, but crystl-level features (isolated shards, quest, project settings, MCP) stay anchored to gem A’s directory. Silently. Same class of foot-gun as the home-rooted-gem issue earlier this week. Two complementary nudges: a one-time terminal hint fires when drift is first detected (yellow ⚠ banner explaining the situation and recommending “+” to make a new gem for the wandered-into folder, gated so it fires at most once per user), and a persistent status-bar indicator shows a yellow ⚠ + yellow-tinted cwd text on the project label whenever the active shard is outside the gem’s project tree (reverts to plain text the moment the shard cd’s back inside). Remote shards skip both checks; the auto-home gem also skips.
  \

2.36.16\

May 15, 2026
\

• Welcome banner now actually appears for users with restored sessions. In v2.36.15 the banner was wired into addProject, which fires once per restored gem during session restoration. The flag-set on the first call locked subsequent calls out, AND the banner was being fed into the first restored gem’s shard (hidden behind the other tabs, since restoration ends with the LAST gem selected). Moved the trigger into a post-restoration hook at +2.5s after launch. It reads the currently-selected session and feeds the banner there, so it lands in the tab the user is actually looking at on first launch of any new version.
  \

2.36.15\

May 15, 2026
\

• Onboarding nudges for the gem/shard mental model. crystl’s default first-launch state is an “unconfigured” gem at $HOME with a single diamond shard. Previously nothing told users this was special, so they treated crystl like any other terminal and missed the central concept. Three small additions: (1) a one-time coloured welcome banner is fed into the first shard’s output explaining gems vs shards and pointing at the status-bar folder icon; (2) the folder icon next to the project label pulses gently while the gem is unconfigured, so you notice it (stops on click or when the gem becomes configured); (3) tooltips on both “+” buttons, new gem (project folder) on the top row, new shard (terminal session in this gem) on the shard row.
  \

2.36.14\

May 14, 2026
\

• Gem title no longer follows the active shard’s cwd.hostCurrentDirectoryUpdate (which fires on every OSC 7 the shell emits, typically once per prompt) was rewriting project.title to the basename of the shard’s cwd whenever the gem didn’t have a custom name. That turned the gem identifier into a breadcrumb of “wherever I last cd’d to”, so a shard wandering into ~ or auto-cd-ing into a worktree path would silently relabel the entire gem. The gem title is now a stable property set at init time and only changes on explicit user edit. Side effects (window subtitle, session cwd tracking, tab observers) still update on OSC 7 as before.
  \

2.36.13\

May 14, 2026
\

• Isolated shards refused when the gem is rooted at $HOME. Some users git init their home directory (for dotfile management or otherwise). Creating an isolated shard on a home-rooted gem made GitWorktree.create correctly produce ~/.crystl/worktrees/<name>, but that pollutes the home git repo with crystl/* branches and scatters shard cwds across the user’s entire home tree. Isolated shards on a home-rooted gem now fail fast with an explanatory error pointing the user at creating a gem for their actual project directory.\
• Loud yellow warning when any new shard is created on a home-rooted gem (isolated or shared). Home is almost always a misconfiguration regardless of shard type, so surface it instead of letting users discover it via downstream weirdness.
  \

2.36.12\

May 14, 2026
\

• Cursor is now visible whether GPU rendering is on or off. The Metal renderer already had a patch forcing the cursor to stay drawn regardless of Claude’s \e[?25l (cursor-hide) spam during status-line redraws. The CoreText renderer didn’t, terminal.cursorHidden = true would remove the caret view from its superview entirely, so users with GPU rendering disabled in General settings were typing into an invisible-cursor box while Claude was running. Mirrored the override into the CoreText path so the caret stays mounted regardless of what the terminal asks for.\
• GPU rendering toggle now states the restart requirement.useMetalRenderer is read once when a terminal session is initialized, so flipping it on a running shard has no effect, easy to misread as a broken toggle. Added a caption under it.
  \

2.36.11\

May 14, 2026
\

• Side quest tab no longer shows the PROJECT DIRECTORY picker or the gem-name row. Side quest connects two arbitrary shards across any gems and is directory-agnostic, it doesn’t operate inside a single directory. The picker was a leftover from the quest-tab layout and implied (incorrectly) that side quest was scoped to the launching gem’s directory. Both sections are now suppressed when the side-quest tab is active, and the panel shrinks to match.
  \

2.36.10\

May 14, 2026
\

• The quest setup panel’s PROJECT DIRECTORY picker now actually controls where the quest runs. Previously the picker accepted edits and looked editable, but for local quests every consumer downstream (shard cwd, isolated worktree base, party.json write, wizard join message, chat panel message reads, file watcher, context analyzer, v2 hook routing) anchored back at the gem’s own directory. So agents launched in the picked dir but the panel kept reading from the gem’s empty .crystl/quests/, making quest features appear inert. Now a single effectiveQuestRoot threads through every read; the picker dir is the authoritative quest location. Persists to the gem’s .crystl/project.json so the anchor survives across app restarts. Open quests cd shards into the picked dir; isolated quests put worktrees under the picked dir’s git repo.\
• The redundant gem-name row in the panel header is gone when there’s nothing custom to show. A gem at ~ with no custom name was rendering “chris” above a path field that read “~”, the same identifier twice. Now the row only renders when the gem’s title differs from its directory’s basename (i.e. a custom name was set). The path picker is the single source of truth.\
• release.sh now tags locally and installs to ~/Applications at the end. Local builds were stamping stale version strings into Info.plist because they read from git describe and the release tag only existed on the remote after gh release create. Now release.sh creates the tag locally before building, and copies the freshly-signed + notarized app into ~/Applications/Crystl.app at the end so the installed version always matches what was just released.
  \

2.36.9\

May 14, 2026
\

• Quest setup panel header no longer overlaps itself. The gem icon and project name row was rendering inside the setup tab bar’s vertical range, causing the “side quest” tab label to collide with the project name (most visible when the project name was long like promptreviews-web). Two builders in the panel layout used mismatched y-coordinate conventions (“decrement before placing” vs “place at y, advance after”); the gap step after the tab bar didn’t account for the gem row’s upward visual extent. Added the missing 17px so the row clears the tab bar cleanly.\
• Side-quest shard picker now shows the shard name on long project entries. The picker drew row text without a truncation paragraph style, so entries like promptreviews-web / diamond clipped at the column’s right edge, hiding the shard name, which is the part users actually pick by. Switched to middle-truncation so both the project prefix (for context) and the shard suffix (for selection) survive on long entries.
  \

2.36.8\

May 13, 2026
\

• SGR rewriter no longer eats CPU on heavy output. The byte-level rewriter that protects against invisible-text-on-glass had been running on every single PTY byte since v2.36.0, copying each one individually into a fresh output array and scanning for escape sequences as it went. For interactive typing that’s free, but for streamed output (build logs, agent token streaming, file dumps) it was a measurable CPU tax that compounded with the App Nap suppression added in 2.36.4 to give a general “crystl is sluggish” feel. Two optimisations cut the cost to near-zero on the common case: a fast-path early return when the slice contains no ESC bytes at all (skips the entire walk and allocation entirely, this catches the vast majority of plain-text payload), and bulk-copying plain-text runs between CSI boundaries instead of per-byte appends. Correctness pinned by 19 SGR rewriter tests including two new ones for the fast path.
  \

2.36.7\

May 13, 2026
\

• Typed text now appears as you type inside Claude Code, not only after you hit Enter. Long-running symptom: characters you typed into Claude’s input box would be completely invisible until submit, at which point they’d all appear at once. Drag-selecting over the “empty” region revealed the bytes were there in the terminal buffer all along. The GPU just wasn’t painting them. SwiftTerm’s 60fps repaint throttle plus its dirty-row tracking can drop typed-input row paints under Claude’s rapid status-line redraw bursts, and the upstream race is the same on both the Metal and CoreText paths. Workaround: force a repaint after every PTY data chunk we receive. Bypasses SwiftTerm’s display queue entirely for the typing case. Marginal extra CPU under heavy output bursts, free for interactive typing.\
• Glass readability: ghost-text grey vs typed-input white now properly distinguished. The renderer-level luminance floor was lifting everything near-grayscale below 235 to pure white, which destroyed Claude’s dim hint placeholder text (it should stay dim grey). The byte-level rewriter also had a “muted agent output → grey-170” tier that itself rendered as light grey on glass, the exact “light grey” complaint we were trying to kill. Fix threads the dim attribute from the SGR stream all the way through to the renderer: the rewriter keeps the dim flag in the output (was stripping it), drops the grey-170 tier entirely (everything it rewrites is now white), and the floor short-circuits on dim to preserve the rewriter’s intentional grey-120 ghost-text substitute. Result: typed input renders crisp white, ghost text renders dim grey, muted agent output renders white, saturated colours pass through untouched.
  \

2.36.6\

May 12, 2026
\

• Typed text actually renders as white now, the long-standing “everything looks translucent grey” bug is finally root-caused and fixed. Weeks of patches at the SGR-rewriting, luminance-floor, dim-attribute, and alpha-blending layers were all chasing a symptom downstream of the real problem. The actual cause: SwiftTerm’s Metal renderer rasterizes glyphs into a Core Text bitmap with macOS font smoothing enabled (setShouldSmoothFonts(true)). Font smoothing is calibrated for dark-text-on-light-bg and bakes a luminance reduction directly into every glyph in the atlas. On crystl’s transparent glass background, that baked-in reduction made light text look uniformly grey regardless of what colour the agent emitted, what colour the shader received, or what we layered upstream. The grey was already in the atlas before anything else got a chance to touch it. Fix: smoothing off in the rasterizer; glyphs go into the atlas at full luminance and read as crisp white on glass.
  \

2.36.5\

May 12, 2026
\

• Typed input no longer turns light grey on later turns within a session. First message looked right, then somewhere around turn three your white input would render as grey for no apparent reason: same bytes, same agent, different colour. Two compounding causes. (1) A build could ship without the SwiftTerm fg luminance floor patch, falling back to SwiftTerm's dimmedColor(towards: bg) which blends the foreground 50% toward the input box bg=(55,55,55) whenever the dim flag is set, so white becomes grey-155. The floor patch is now applied on every build. (2) The floor's dim + bright → grey-120 branch was actively harmful: the byte-level rewriter already substitutes explicit grey-120 for lone \e[2m ghost-text, so any bright+dim pair reaching the renderer-level floor was a stuck SwiftTerm dim flag, and dimming bright text in that case produced exactly the user-visible bug. Removed the branch. Bright fg now always passes through regardless of dim state.
  \

2.36.4\

May 11, 2026
\

• Backgrounded terminals keep painting in real time. Previously, if you clicked away to another app while Claude was working, the terminal screen would freeze in place, bytes still arrived on the PTY read queue and updated the buffer in memory, but the queued display-refresh blocks didn't fire often enough to repaint. When you came back, the screen would snap forward in one jump to wherever Claude was now (often already finished), giving a "frozen but secretly working" experience. Cause: macOS App Nap throttling crystl's main run loop while another app was focused. Fix: ProcessInfo.beginActivity for the app's lifetime, same pattern Terminal.app and iTerm2 use. System sleep behaviour is unchanged.
  \

2.36.3\

May 11, 2026
\

• Typed input renders uniformly readable on glass, for real this time. The byte-level SGR rewriter was a losing battle against every variant agents emit; sequences split mid-word kept producing visible dim/bright transitions. The fix moves the floor to the SwiftTerm render layer: every painted glyph now goes through a luminance floor, so any near-grayscale dark foreground is lifted to readable at paint time, regardless of what bytes the agent sent or how they split across slices. Policy: dim + dark-near-gray → crisp white (typed input); dim + bright → grey-120 (ghost-text); no-dim + dark-near-gray → grey-170 (muted agent text); saturated colors pass through unchanged. The contract is pinned by a unit test suite that fails to compile if a SwiftTerm bump drops the patch.
  \

2.36.2\

May 9, 2026
\

• Cursor no longer disappears in shards running Claude Code. CC emits \e[?25l (hide cursor) constantly during status-line redraws, and on stock SwiftTerm the Metal renderer skipped drawing the cursor for that frame, between redraws it never recovered, so the cursor visibly vanished. The cursor is now always drawn, regardless of CC's hide signal. The patch is now applied at build time via build.sh instead of being a stray uncommitted edit, so it survives any clean SwiftTerm re-resolution.\
• Patch: typed input now renders uniformly white instead of half-white-half-grey. v2.36.1 made some typed text crisp white but missed a redraw path where Claude Code splits the typed-input fingerprint across two SGR sequences (\e[2m first, then \e[38;5;239m later). The rewriter now tracks the dim attribute cumulatively across sequences, so the second SGR's near-grayscale dark fg is correctly classified as typed input and rewritten to full white, even at line-wrap boundaries where the split most often shows up. Also resolves the related "completely invisible character" cases.
  \

2.36.1\

May 9, 2026
\

• Patch: typed input now renders crisp white instead of muted grey. Claude Code wraps every typed character in a dim attribute plus a near-grayscale dark foreground; on the glass background that combination renders near-invisible without the SGR rewriter, and the rewriter's previous policy brightened it only as far as grey-170. The new policy detects the typed-input fingerprint (dim + near-grayscale dark fg) and rewrites the foreground to full white. Muted agent text (dark-gray fg without dim) still rewrites to grey-170 so it stays visually distinct, and the lone-dim ghost-text hint stays at grey-120.
  \

2.36.0\

May 7, 2026
\

• You'll know when an agent crashes inside an isolated shard. Previously when Claude (or any agent process) exited on its own inside an isolated shard, crystl silently auto-closed it and you were left wondering whether your work was saved. Now a non-blocking notification fires: “agent in {crystal name} exited, branch crystl/{name} kept with N commit(s)” (or “branch removed (no work to save)” if nothing was committed; appends “+ uncommitted changes” if you had untracked work). The user-driven close path with the merge prompt is unchanged.\
• Every save button now flashes “saved” before dismissing. The pattern shipped in v2.35.0 for APIKeys and Facets settings is now extended via a shared helper to IconPicker, ClaudeTemplateEditor, StarterEditor, QuestPartyEditor, and QuestRoleEditor panels. Brief title flip + crystlAccent brighten + 1s dismiss everywhere a save closes a panel.\
• Smarter resumption-burst suppression. The 30-second fingerprint rate-limit from v2.34.1 was imprecise, legitimate Stop hooks within the window could be suppressed and the resume storm could leak through if message text differed. The principled fix: when crystl auto-runs claude --resume for a session, it marks a 5-second window during which Stop hooks for that exact session ID are dropped at intake. The 30s fingerprint window stays as a safety net. Tunable via defaults write com.crystl.app resumptionWindowSeconds -int 5.\
• Three more panel-monitor leak fixes. NewProjectPanel, HistoryPanel, and IconPickerPanel each now have a deinit that removes their global click monitors / NotificationCenter observers as a belt-and-suspenders fallback for missed dismiss() calls.\
• 57 button corner radii normalized. Off-spec cornerRadius = 6 sites bumped to the spec cornerRadius = 8 across 28 files (FacetBar, HistoryPanel, StarterEditorPanel, FileMaps, AgentFiles, Editor, Library, Helpers, DenialPanels, SettingsView, drag-drop rows, etc.). Small visual nits adding up to a more consistent feel.\
• All 6 audit hard-ceiling violators are now split. v2.35.0 covered four; this release finishes the job with AgentBlockLibraryPanel (686 → 350 + 4 extension files, with the Tier 3 9pt chip fix applied in flight) and AgentFileEditorPanel (635 → 346 + 4 extension files). Pure reorganization, no behavior change.\
• +20 unit tests (378 → 398). New regression nets for the agent-exit message helper (7 tests) and the resumption-window suppression (13 tests on session-id windowing).
  \

2.35.0\

May 6, 2026
\

• Active gem highlights brighter on the rail. The previous selected vs unselected delta was dominated by the border; bg fill and icon alpha barely differed. Bumped selected bg alpha 0.25 → 0.42 and border alpha 0.6 → 0.9 so the active gem reads at a glance, and softened the inactive icon dim so they stay legible alongside it.\
• Rail icons stay readable at low opacity. The transparency slider's glass.alphaValue was cascading to every tile, button, and icon, at the most-translucent end (alpha 0.2) tile icons dropped to ~13% effective alpha and were nearly invisible. Restructured so the glass blur sits at the back as a sibling of the interactive views, not their parent. Only the blur fades; tiles and icons stay at full alpha regardless of slider position.\
• Bridge token persists across crystl restarts. Every crystl restart used to write a fresh random token to ~/.crystl-bridge-token, which broke every SSH-tunneled shell because shell-init captures the token via env at spawn time. Now the existing token is reused (validated as 32- or 64-char hex; corrupt files regenerate cleanly). Tailscale and SSH-relay users no longer get 401s in every existing shell after a crystl restart.\
• Three more c9a3799-pattern panel races fixed. Same shape as the v2.34.0 fix: synchronously clearing setupPanel inside dismiss() chains dropped the strong reference before animatePanelOut's onDismiss could fire. Three additional sites covered (RailSettings toggle, RailSettings open path, AppDelegate onWillShowPanel).\
• New --no-install flag for build.sh. Compile-only build that skips overwriting ~/Applications/Crystl.app. Agents building from worktrees should use this, avoids the “crystl won't open” failure mode where the installed app's Bundle.module path was baked to a worktree that later got cleaned up.\
• +77 unit tests (301 → 378). New regression nets for shellEscape (security-critical, was untested), MCPConfig merge (user-managed .mcp.json entries must survive sync), LicenseManager edge cases (.expired → .free tier), APIKeyStore Keychain round-trip (constructor-injected service name so tests can't pollute the real Keychain), and OSC 7770 parser (extracted into a pure function).\
• All 6 audit hard-ceiling violators split. ChamberSetupPanel, AgentFileEditorPanel+BlockView, FileLibrarySettingsPage, NewProjectPanel, AgentBlockLibraryPanel, AgentFileEditorPanel, all now under 400 lines, with the workhorse logic in +Suffix.swift extension files. Pure reorganization, no behavior change. Plus a Tier 3 UI hygiene pass across ~20 files (alpha-floor lifts, sub-10pt font bumps, ~50 inline NSFont calls migrated to Typography tokens, isHidden = true → layer.opacity = 0 on glass-overlapping views).
  \

2.34.1\

May 6, 2026
\

• Patch: startup notification spam fixed. Restarting crystl with restored Claude sessions used to cause a flood of identical “command completed” panels. Root cause: claude --resume re-fires Stop hooks for every prior assistant turn in the transcript, and crystl had no rate-limit on identical events at intake. v2.33.0's dismissal-suppression only kicked in after the user dismissed one. By then the burst had already stacked up. This patch adds a 30-second rate-limit on identical event fingerprints (same session, hook type, and message prefix), so the burst collapses into a single panel. Also catches tool loops firing the same Stop repeatedly, and any other source of bursty identical hooks.
  \

2.34.0\

May 6, 2026
\

• Worktree integrity hardening. Five fixes covering the audit's Tier 2 worktree cluster: replaced symlinks (e.g. npm install overwriting .claude/) are detected on session start and moved aside with a .crystl-replaced-{timestamp} suffix instead of letting per-shard config leak to main; the crystal-name validator is now actually enforced at every entry point that accepts a user/external name; the shard prompt body in autorun.sh is single-quote-escaped so a malicious branch name can't execute attacker-chosen shell; the crystal-name allocator considers all crystl/* branches as occupied (not just orphans-with-work) so stale empty branches don't get silently branch -D'd; and remote SSH disconnect during close now preserves state so the orphan can be cleaned up on reconnect.\
• Two more c9a3799-pattern panel races fixed. Same shape as the gem-settings stuck-after-save bug: openGemFromPicker and showQuickModePicker were clearing the panel's strong reference synchronously before animatePanelOut's onDismiss could fire. Now rely on the callback after the animation completes.\
• Terminal NSEvent monitor leak plugged.removeScrollForwarding() was defined but never called, each session close left four global event monitors registered forever. Now called from the close paths and from a new deinit on the terminal-view subclass.\
• Three asyncAfter strong-capture bugs fixed. The 0.3 to 0.5s asyncAfter blocks in openSSHURL, showGemSettings, and setGemApprovalMode kept closed sessions alive just to feed a banner to a now-orphaned terminalView. Now [weak session] with a guard.\
• SGR rewriter hardening. The pendingCSI buffer is capped at 4 KiB so a malformed CSI from a buggy or hostile emitter (ESC [ with no terminating final byte) can't OOM the process; on overflow the bytes flush to output as raw and the buffer resets. CSI parameter / intermediate / final phases are now walked explicitly per ECMA-48.\
• build.sh hard-fails when SwiftTerm sed patches can't apply. Previously a SwiftTerm refactor that renamed snappedWidth / metalDirtyRange / etc. would silently leave builds shipping unpatched code, regressing the “invisible text on glass” bug class. Now the build aborts loudly so the regression can't ship.
  \

2.33.0\

May 6, 2026
\

• Bridge security hardening. The in-process bridge that handles Claude Code's permission hooks now requires bearer authentication on all endpoints (previously loopback was exempt, which let any local process or DNS-rebinding browser POST decisions). Adds a strict Host header check that rejects rebound hostnames and any request carrying Origin or Referer; opt-in bridgeRemoteAccess for Tailscale / VPN / port-forwarding setups. Caps request bodies at 1 MiB with a 413 response before any body is buffered. Pairs each fix with a regression test in CI so the same drift can't slip back in.\
• Worktree data-loss prevention. Three close-time data-loss scenarios fixed: (1) commitsAhead now uses a stored fork point so worktrees with real commits don't silently report zero-ahead and get deleted when the project is on a feature branch; (2) untracked files in a worktree count as work to preserve, so agent-created files that were never git added are no longer force-removed on close; (3) corrupt-worktree recovery refuses to destroy a branch that has commits, so a transient lock file or permission flap can't trigger a silent git branch -D.\
• scp upload paths shell-escaped. Remote file uploads via SSH now use a cat | ssh ... > $(escaped path) pipe instead of raw scp host:path, so a remote path containing ; or backticks can't execute on the remote host.\
• Dismissed notifications stay dismissed for 10 minutes. Identical events (same session, same hook type, same message prefix) are suppressed within the window. Protects against claude --resume replaying transcript hooks on session restore, pathological tool-loop floods, and any other source of bursty repeats. After 10 minutes a fresh occurrence re-fires normally.\
• SSH integration test harness + GitHub Actions CI. A sandboxed sshd on 127.0.0.1:2222 backs end-to-end remote-session tests; CI runs both unit and SSH suites on macOS for every push. 31 new bridge regression tests cover the audit-touched paths so future security fixes can ship without breaking SSH features.
  \

2.32.0\

May 5, 2026
\

• Tool output and typed input render bright again on glass: 2.30.0 introduced a darker rewrite path for any SGR carrying the dim attribute, to keep Claude Code's ghost-text placeholder visually distinct from typed text. But Claude emits its tool output, git output summaries, and even your typed input as dim + near-grayscale-dark fg, so all of that ended up rendered at gray-120 (visibly dull on glass). The dim-darken now applies only to the ghost-text case (lone \e[2m…\e[22m with no explicit fg). Anything with an explicit fg rewrites to bright gray-170 as before.
  \

2.31.0\

May 5, 2026
\

• Gem settings panel closes again after save: clicking save in gem settings flashed the green “saved” state but then left the panel stuck on screen. The X, Escape, and click-outside were all silently dead. The onSubmit callback was clearing the panel's strong reference synchronously, so the panel deallocated before the post-save dismiss timer could fire, AppKit kept the window on screen with all its targets dangling. The strong reference now lives until animatePanelOut actually completes.
  \

2.30.0\

May 4, 2026
\

• Claude Code ghost-text reads dimmer than typed text again: the placeholder hint (e.g. Try "write a test for ") was rendering at the same brightness as what you actually typed. The SGR rewriter that fixes invisible-text-on-glass was stripping the dim attribute entirely, including the lone \e[2m…\e[22m blocks Claude uses for the ghost-text placeholder. Now dim-attributed text rewrites to a darker gray than regular grayscale text, and a lone dim sequence substitutes an explicit darker fg so the hint survives even when no fg color is set in the source SGR.
  \

2.29.0\

May 3, 2026
\

• Quest wrapper installs only when you summon a party: previously every non-diamond shard got the quest verbs and claude() wrapper installed at creation time, even if you weren't running quest. On session restore the +0.8s inject lost the race to claude --resume and the bootstrap text (source /tmp/crystl-quest-…) ended up in Claude's input box. Now the wrapper is installed only when a quest party is actually summoned. Side quests already worked this way; nothing changes there.\
• Side-by-side builds no longer share config files: both were reading and writing ~/.config/crystl/ for last-session, formations, facets, MCP catalog, file library, agent blocks, claude/starter templates, and bridge settings, so quitting one and launching the other restored the wrong workspace and overwrote the other's saved state. A second build now uses its own config directory. License key and hero-image cache stay shared (one Guild membership covers both, and the cache is just a CDN download).
  \

2.28.0\

May 3, 2026
\

• Readable input on glass: fixes invisible text when typing into Claude Code. The agent's input prompt was emitting 256-color and truecolor SGR codes that bypassed the 16-color palette floor and rendered as near-black on the transparent background, you'd type a sentence and only see it after pressing return. crystl now intercepts the PTY byte stream, parses CSI sequences, and rewrites near-grayscale dark foregrounds to a readable light gray. Saturated colors (red, blue, green) are preserved at any luminance.
  \

2.27.0\

April 30, 2026
\

• Close all gems: new File → close all gems action for a one-click "start fresh". A single confirm dialog lists every running agent and unmerged isolated-shard branch across all open gems; on accept, the saved-session pointer is cleared so the next launch is empty, and a single fresh unconfigured gem replaces what was closed. Menu item disables itself when the only open gem is already fresh.
  \

2.26.0\

April 29, 2026
\

• End Quest: new File → end quest action stands the party of agents down. A [quest ended] banner is bracketed-pasted into each shard, then every quest verb (quest_msg, quest_heartbeat, quest_task, quest_summary, quest_handoff, quest_announce, quest_claim, quest_note) is rewritten to a stub returning {"ok":false,"error":"quest_ended"} so already-running agents learn to stop reporting through their normal feedback channel. Works for local + remote (SSH) shards. The menu item is disabled when no shard is in a quest.
  \

2.25.0\

April 29, 2026
\

• Side Quest panel matches Quest UX: hero sidebar with crystal-color dots, name + gem, and a context lifebar; — X joined the side quest — rows on open; CRT-fade crystl side quest logo splash; cleaner header with identity moved to the sidebar; messages bottom-anchored like Quest.\
• Side-quest agents follow the protocol: the start banner now declares the rule explicitly: reply only by running sidequest_msg via the Bash tool, never as plain chat. Each routed message also carries a per-message reply reminder so the protocol stays in working context turn over turn.
  \

2.24.0\

April 28, 2026
\

• Glass-readable terminal palette: install all 16 ANSI colors with values tuned for the transparent background, eliminating dark/black text in TUI apps like Claude Code
  \

2.23.0\

April 28, 2026
\

• crystl://ssh URL scheme: open remote SSH sessions from other apps or scripts with open "crystl://ssh/user@host/path"
  \

2.22.0\

April 28, 2026
\

• crystl:// URL scheme: open any project from other apps or scripts with open "crystl:///path/to/project"
  \

2.21.0\

April 27, 2026
\

• Quest message injection: messages sent from the quest chat panel now correctly submit in Claude Code's terminal; fixes text appearing in the input buffer but never executing (Kitty keyboard protocol + bracketed paste)
  \

2.20.0\

April 27, 2026
\

• Quest message delivery: fixed quest_announce and quest_task writing to an unwatched path; messages now reliably appear in the quest panel\
• SSH quest messages: quest_msg now resolves its log path at runtime so remote agents write to the correct location\
• Quest message persistence: messages sent while crystl is closed are replayed on next open via a cursor file\
• Quest panel colors: agent names in the Tasks and Summaries tabs now render in their crystal colors\
• Live summary feed: new summaries append in real-time when the Summaries tab is visible\
• SSH hook reliability: quest verbs retry hook delivery 3 times with a warning on total failure\
• Quest setup: tilde in project path field now expands correctly before git repo checks
  \

2.19.76\

April 27, 2026
\

• Gem settings close button: moved to top-right corner, removed invisible title bar that blocked clicks
  \

2.19.74\

April 26, 2026
\

• Scriptability API: local HTTP API (/api/v1/) for programmatic control of gems, shards, permissions, and terminal content\
• crystl CLI: 11 commands: status, gems, open, close, shards, send, screen, pending, approve, deny, token\
• SSE event stream: real-time notifications and permission request events at /api/v1/events\
• Security: bearer token auth on all API routes, remote /send disabled by default
  \

2.19.73\

April 26, 2026
\

• Click-to-open fix: clicking file paths in Claude Code output now opens correctly instead of showing error -50\
• Relative path resolution: relative paths resolved against session working directory, not app process directory\
• SSH file click: file:// links over SSH download via SCP then open locally
  \

2.19.72\

April 26, 2026
\

• StopFailure notifications: glass panel appears on API errors: rate limit, auth expired, billing, server error, max tokens\
• PermissionDenied panels: auto mode denials now show a retry/dismiss panel instead of failing silently
  \

2.19.71\

April 25, 2026
\

• Session resurrection: restores gems, shards, and Claude sessions on startup with zero clicks\
• SSH session restore: SSH shards auto-reconnect, cd to remote directory, and resume Claude sessions\
• Settings toggles: restore last session and resume Claude sessions toggles in General settings
  \

2.19.69\

April 25, 2026
\

• SSH hook fix: fixes permission auto-reject on SSH sessions caused by duplicate hook entries accumulating across builds\
• Bridge failsafe: when bridge is unreachable, Claude Code now falls through to CLI prompt instead of silently rejecting
  \

2.19.66\

April 24, 2026
\

• Option+drag to select text: in tmux/vim, hold Option while dragging for native text selection, then Cmd+C to copy. Matches iTerm2/Alacritty/Kitty convention.\
• OSC 52 clipboard bridging: tmux can now copy selection to system clipboard via escape sequences\
• tmux drag forwarding: mouse drag events forwarded to tmux for click-drag selection highlighting\
• One-time hints: brand blue hints for Option+drag and mouse mode on first use
  \

2.19.63\

April 23, 2026
\

• tmux scroll support: scroll events forwarded to tmux when mouse mode is on; one-time hint when it's off\
• Drag to reorder gems: drag tab bar tabs with insertion indicator, rail tiles stay in sync\
• 32 preset colors: doubled color palette with deep, rich, and earth tones; scrollable horizontally\
• New gem panel reorder: identity at top, setup at bottom; consistent 16px header spacing\
• Image drag: shows [image #] via native paste; window re-focuses after drag\
• Bare URL detection: clicking domain.com/path opens browser instead of erroring
  \

2.19.62\

April 23, 2026
\

• Drag to reorder gems: drag tab bar tabs to rearrange project order, rail tiles stay in sync\
• Image drag: dragging images into the terminal now shows [image #] instead of raw file paths\
• Bare URL detection: clicking URLs like ads.google.com/path opens the browser instead of erroring\
• SSH freeze fix: gem settings no longer blocks the main thread on stale SSH connections\
• Close button fix: gem settings close button works reliably, brightens on hover
  \

2.19.59\

April 21, 2026
\

• Ecosystem-colored tags: block tags colored by platform: Swift orange, TypeScript blue, React cyan, Python green, and more\
• Inline categories: category label next to block title instead of stacking vertically\
• Tag-aware search: editor block search now matches tags and categories\
• New block dialog: category dropdown + clickable tag chips for swift, macos, typescript, etc.\
• Context load: lines: LINES column in token usage panel showing file line counts\
• Optimizer animation: staggered fade-in on load and re-analyze\
• 10 Swift/macOS rules: new library blocks for Swift development
  \

2.19.58\

April 20, 2026
\

• Save feedback: save buttons flash "saved" with bright green confirmation before reverting\
• Explore tab: optimizer "map" renamed to "explore" with folder-open icon; "+" buttons on directories to add saved files\
• Library hints: "?" buttons on library blocks show the explanation text in the preview area\
• Agent block library: larger panel, proper search field styling, more preview space\
• Blank rule removed: rule/skill menus no longer offer a useless blank heading option\
• Gem panel fix: title text no longer clips descenders on "g" in "gem settings"
  \

2.19.57\

April 19, 2026
\

• Rule/skill picker: add rule and add skill show a menu of available blocks with content previews\
• Drag to zones: dragging blocks from the library into the RULES or SKILLS zone sets the correct block type\
• Source mode: raw markdown editor has a proper rounded input area\
• Editor zones: rules/skills zones only appear when directories exist on disk\
• SSH directory picker: cd command now sent to remote shell\
• New gem layout: starter bundle section moved below icons, above MCP
  \

2.19.55\

April 19, 2026
\

• Add to project: library templates have a project picker to deploy files to any open gem\
• Simple file editor: lightweight glass editor for .claudeignore, settings.json, and other non-block files\
• Blank new files: new file templates start empty; starter kits keep the scaffold\
• Custom filenames: templates can target any path, not just predefined agent file types
  \

2.19.54\

April 19, 2026
\

• 17 new optimizer checks: testing commands, code conventions, stack detection, verification gate, commit discipline, stale paths, cross-file consistency, gitignore misconfig, hooks, and permissions\
• Weighted scoring: content quality weighted 3x higher than setup; AGENTS.md only penalizes multi-agent projects\
• Copy for agent: export button writes optimization-report.md and copies a prompt to clipboard for pasting into Claude or Codex\
• Bundle starters: new gems get .claudeignore and .claude/settings.json scaffolds automatically\
• New blocks: Verification Gate, Commit Discipline, and Tool Restrictions available in the block library\
• SSH gem settings fix: agent file checks now hit the remote filesystem instead of the local home directory
  \

2.19.52\

April 19, 2026
\

• Project Optimizer over SSH: health scores, gap detection, file creation, and the map/files views all read and write through the SSH connection\
• File Library rules over SSH: .claude/rules/ listing, creation, editing, and deletion now work for remote projects\
• File Maps panel over SSH: rule listing, file editing, add-file, and add-rule all SSH-aware\
• Accurate context load for SSH: burn rate now correctly accounts for CLAUDE.md and AGENTS.md on remote hosts\
• Gem settings CLAUDE.md detection: correctly detects existing CLAUDE.md on SSH projects
  \

2.19.51\

April 19, 2026
\

• SSH agent editor: agent files can now be opened, edited, and saved on SSH remote projects; rules and skills load and save correctly over SSH\
• ProjectFilesystem: new internal abstraction routes all file operations to either the local filesystem or SSH, eliminating local-only guards throughout the app\
• SSH agent files grid: gem settings now shows the correct agent files for remote projects
  \

2.19.50\

April 19, 2026
\

• Tabbed agent editor: tabs match the terminal gem tab style: separator line, active background, × close, + add, same fonts and spacing\
• Close to delete: closing a tab permanently removes the agent file from disk (with confirmation)\
• Add menu: pick any known agent type or enter a custom filename (cursor.md, aider.md, etc.)\
• Auto-detect: AGENTS.md, GEMINI.md, .cursorrules, .windsurfrules, .github/copilot-instructions.md open automatically as tabs\
• Gem settings grid: agent files shown as a clean two-column grid, no false positives from unrelated .md files
  \

2.19.46\

April 17, 2026
\

• Rules divider: blue zone in the CLAUDE.md block editor; blocks below become individual .claude/rules/*.md files\
• Skills divider: purple zone below rules; blocks become .claude/commands/*.md slash commands\
• Drag across zones: move content between CLAUDE.md, rules, and skills by dragging blocks across dividers\
• Auto-load: existing rule and skill files load into their zones when opening a project's CLAUDE.md\
• PLANS.md: new file type for OpenAI Codex execution plan templates
  \

2.19.45\

April 17, 2026
\

• GEMINI.md support: create and manage Google Gemini CLI instruction files\
• Optimizer line count: flags CLAUDE.md over 200 lines with suggestion to split into rules\
• Map view add file: "+ add file" button opens file chooser panel from any directory\
• Map view add rule: "+ add rule" button with name and path-scope dialog in .claude/rules/
  \

2.19.44\

April 17, 2026
\

• File chooser panel: glass panel with icons and descriptions for creating project files (CLAUDE.md, AGENTS.md, codex.md, .cursorrules, and more)\
• CLAUDE.md w/rules: recommended option that creates CLAUDE.md + .claude/rules/ directory together; badge in the chooser\
• Claude rules tab: manage .claude/rules/*.md files in File Library settings with name and path-scoping support\
• Line count bar: CLAUDE.md editor footer shows live line count; turns yellow at 150, red over 200\
• Codex.md templates: dropdown in New Gem panel for selecting codex.md templates\
• Separate skill sections: Claude Skills and Codex Skills as distinct sections in New Gem panel
  \

2.19.41\

April 16, 2026
\

• Optimizer SSH guard: "optimize" button is now hidden for SSH gems; the analyzer reads local filesystem only and would scan the wrong directory for remote sessions
  \

2.19.40\

April 16, 2026
\

• SSH show button fix: approval panel "show" now correctly navigates to the originating shard for port-forwarded SSH sessions (connections without user@host format)
  \

2.19.39\

April 16, 2026
\

• Formations fix: project names now restore correctly for SSH gems; port-forwarded sessions were silently dropping names on save
  \

2.19.38\

April 15, 2026
\

• Skills import fix: importing from the skills library now installs files directly to ~/.claude/commands/; previously nothing was written to disk\
• Section header UX: block editor section rows are now inline-editable (no more double-panel expand)\
• File Maps: hide non-existent instruction files; add library shortcut at bottom\
• Gem settings panel: refactored, adds optimizer shortcut in edit mode
  \

2.19.37\

April 15, 2026
\

• Remove File Maps window: per-project agent setup coming as part of gem settings
  \

2.19.36\

April 15, 2026
\

• File maps fix: panel title no longer overlaps traffic light buttons
  \

2.19.35\

April 15, 2026
\

• Rename "crystl codex" to "crystl library" throughout
  \

2.19.34\

April 15, 2026
\

• File Library: new settings page with a block-based CLAUDE.md editor, Claude skills manager (.claude/commands/), and Codex skills manager (~/.agents/skills/)\
• Block editor: compose instruction files from reusable blocks; drag to reorder, inline heading edit, save any section to your block library\
• Guild: browse 200+ blocks & skills: import agent blocks (rules + workflows), Claude skills, Codex skills, and file templates directly from the crystl.dev library\
• 7 instruction file types: expanded support for CLAUDE.md, CLAUDE.local.md, AGENTS.md, codex.md, .cursorrules, copilot-instructions.md, .windsurfrules with type-specific scaffolds\
• File Maps panel: browse agent config files across all your projects from the Window menu\
• Image drag-drop fix: drop now only intercepts in remote (SSH) sessions; local sessions pass through to Claude Code natively
  \

2.19.33\

April 15, 2026
\

• Remote session fix: gem settings save no longer sends cd + clear to the terminal when connected via SSH or running a process\
• Facet bar redesign: unified segments with inline dropdown triangles, diamond settings icon with hover glow
  \

2.19.32\

April 15, 2026
\

• Context Map: new settings page for viewing agent config files across all projects. Drillable subdirectories, color‑coded type badges (Claude, Codex, Cursor, Aider, Copilot, Windsurf), coverage bars, discovered projects, and tracked files reference\
• SSH config alias fix: bare hostnames like ssh myserver are now correctly detected for image paste, drag‑and‑drop, and remote features\
• Quest settings rearranged: user character is a compact bar on the left, heroes moved to right column\
• DM unread indicators: dot on DM channel pills, badge on dms toggle, distinct two‑note DM sound\
• Gem settings accordions: collapsible PROJECT FILES, SKILLS, MCP sections with Lucide chevrons\
• Renamed starter files → agent files
  \

2.19.31\

April 14, 2026
\

• SSH host parsing fix: port‑forwarded connections (-L, -R, -D) no longer misdetect the forwarding spec as the hostname. Fixes SCP uploads, drag‑and‑drop, and remote features for port‑forwarded SSH\
• Paste fallback: if SCP fails, the local file path is pasted instead of silently dropping\
• DM unread indicators: unread dot on DM channel pills, badge on “dms” toggle button\
• DM sound: two‑note ascending ping, distinct from the main chat tick
  \

2.19.30\

April 14, 2026
\

• File logger: crystl now writes to ~/Library/Logs/Crystl/crystl.log with 5 MB rotation. Bridge and paste diagnostics logged for easy debugging
  \

2.19.29\

April 14, 2026
\

• Hardened image/file paste: checks 6 pasteboard types for cross‑macOS‑version reliability, adds NSImage fallback for non‑standard clipboard managers, and diagnostic logging for SSH upload debugging
  \

2.19.28\

April 14, 2026
\

• Quest report export: export button in the quest panel generates a timestamped Markdown report with party roster, message counts (main + DM), token usage per shard, user prompts, git diff, and chat log\
• SSH image/file paste: Cmd+V of images and files now uploads via SCP for remote sessions, matching drag‑and‑drop behavior
  \

2.19.27\

April 14, 2026
\

• Smart image/file paste: Cmd+V of files from Finder pastes full shell‑escaped paths instead of bare filenames. Cmd+V of screenshot image data saves to a temp PNG and pastes the path. Regular text paste is unchanged\
• Retooled demo: the in‑app demo now showcases all panel types in sequence: permission panel, question notification, and multi‑question series with architecture questions
  \

2.19.26\

April 13, 2026
\

• Collapsible accordion sections: PROJECT FILES, SKILLS, and INCLUDE MCP in gem settings are now collapsible with Lucide chevron disclosure icons. Sections default to collapsed for a compact panel. Insert buttons use brand blue with hover state
  \

2.19.25\

April 13, 2026
\

• Marquee scroll: hovering a gem tab with a truncated name scrolls the text left to reveal the full name\
• External notifications dropped: notification hooks from Claude Code running outside crystl are now silently ignored, preventing spurious “Claude is waiting for your input” panels
  \

2.19.24\

April 13, 2026
\

• Scrollable tab & shard bars: gem tabs and shard pills now scroll horizontally when they overflow. The + and split buttons follow naturally after the last item, pinning to the right edge only when overflow occurs. Quest and isolation buttons stay visible\
• Quest join sound fix: the “join” chime no longer plays when adding shards outside of an active quest session
  \

2.19.23\

April 12, 2026
\

• Screenshot bar: a thumbnail strip at the bottom of the window showing your recent screenshots (powered by Spotlight). Drag a thumbnail into the terminal to paste the file path, or double‑click to open. Toggle via View > screenshot bar (⇧⌘S). Visibility persists across restarts\
• View menu fix: removed duplicate “increase font size” entry
  \

2.19.22\

April 12, 2026
\

• Quest directory fix: all four quest modes (local/remote × open/sealed) now use the directory shown in the setup panel. Quest setup defaults to your current working directory instead of the gem root\
• SSH cwd tracking: remote shells emit OSC 7772 via precmd hooks (zsh + bash) so crystl always knows the remote working directory. Replaces the broken pwd‑over‑new‑channel approach\
• SSH exit detection: disconnecting from SSH clears remote state so quest setup correctly switches back to local mode\
• Local directory picker: quest setup now has a browse button for local projects, using the existing glass directory picker\
• Join messages: remote quest shards now show “has joined your party” in chat, with dedup guard to prevent double posts
  \

2.19.21\

April 12, 2026
\

• Quest v2 Phase 2: SSH remote parity complete: all v2 verbs install on remote shards, hooks mirror state back to crystl, local state is uploaded to remotes, and remote shards get v2 prompts. New ambient feed UI adds tasks, summaries, and per‑shard progress tabs to the quest panel\
• SSH panel routing fix: all panel types (notification, approval, denial, ask‑user) now use shard‑aware project matching so SSH gems sharing the same local path route to the correct project\
• Tasks tab fix: JSON key mismatch (task_id vs id) caused silent decode failure and empty tasks tab\
• Shard pulse: working shards now pulse more visibly (0.3‑1.0 range); selected shard’s underline breathes when its agent is active\
• Context health bar fix: dev mode synthetic data no longer corrupts real agent metrics
  \

2.19.20\

April 12, 2026
\

• New gem name fix: clicking “+” in the tab bar no longer inherits the name, icon, and color from a previous gem's config at ~/.crystl/project.json\
• SSH formation loading: the cd into saved remote directory now waits for the actual SSH connection (OSC 7771 signal) instead of a blind 1.5‑second timer, so slow networks and password prompts no longer lose the command\
• Multi‑SSH shard fix: shard restoration now tracks project indices directly instead of path matching, fixing wrong‑project targeting when multiple SSH gems share the same local path
  \

2.19.19\

April 12, 2026
\

• Crash fix: crystl could crash with a SIGABRT in SessionBarView.draw when CoreText's TAttributes::ApplyFont encountered a nil value while processing SF Mono's variable‑font feature dictionary. The two shard‑label fonts are now cached as static stored properties and pre‑fetched before the draw loop, preventing any race between first‑load and the 20 Hz pulse timer\
• Quest verbs: added quest_claim and quest_announce verbs; improved prompt quality and question detection accuracy
  \

2.19.18\

April 12, 2026
\

• Quest inter‑shard communication fix: the status‑file hint pointed agents at .crystl/quest/v2/messages.jsonl but quest_msg writes to .crystl/quest/messages.jsonl, so agents always saw an empty file and couldn't read each other's messages. Fixed the path so agents can now read the shared quest log\
• No more duplicate messages: the file watcher was re‑writing messages it read from disk back into the JSONL file with a new UUID, doubling every entry. Now passes fromFile: true through the protocol so file‑sourced messages skip the write‑back\
• quest_msg confirmation output: quest_msg now prints {"ok":true,"id":"..."} on success, matching the v2 verb convention so agents can verify delivery\
• Recon‑first quest protocol: agents are now instructed to read messages.jsonl and survey the repo before writing any code, preventing incompatible tech‑stack decisions. Key decisions (architecture, framework choice) are posted immediately so teammates can align\
• Click‑to‑open refactor: replaced custom mouse‑event click‑to‑open with SwiftTerm's native link system\
• Notification shard resolution: notification hooks now resolve the correct shard via cached session_id
  \

2.19.17\

April 11, 2026
\

• Per‑shard identity fix: message sender attribution, working/ready state, and context health metrics were all routing to the wrong shard when CRYSTL_SHARD was inherited into crystl's own environment (e.g. launching crystl from inside another crystl tab). Fixed with two‑layer defense at the env‑inheritance layer so it can't regress silently\
• Context health bar rebased on usable budget: the bar used to count Claude Code's fixed startup cost (system prompt, tool definitions, walked‑up CLAUDE.md files) against the shard's budget, so it could drop to yellow on the very first turn with no work having happened. Now uses the first recorded turn as a baseline and measures only real per‑turn work accumulation. turnsRemaining also estimated against usable budget\
• Question detection false‑positives: the trailing‑decoration strip was chewing past closing code fences and JSON terminators into embedded ? characters inside string literals, lighting up “has a question” cards on turns where the agent wasn't asking anything. Now scoped to the last non‑empty line of the message so structural delimiters can't trigger
  \

2.19.16\

April 11, 2026
\

• Quest v2 operational verbs: four new shell commands for shard‑to‑shard coordination. quest_heartbeat writes live status + current task + optional blocker. quest_task delegates async work to another shard with ownership tracking. quest_summary checkpoints progress on a task without handing off. quest_handoff hands off the full task with decisions / blockers / next steps, optionally auto‑assigned. Each verb ships as a bash script installed into every local shard's bin‑<shard>/ at session start and returns structured JSON with exit codes for scripting\
• Structured quest state files: new .crystl/quest/v2/ layout with per‑shard progress/, status/, tasks.json, and an append‑only summaries.jsonl. crystl writes context_pct into each shard's progress file from hook metrics, so teammates can cat the files for live situational awareness without replaying the chat\
• Healer context‑watching: shards with the Healer role now get a system‑prompt addendum that tells them to read the progress files during their own turns and nudge any shard below 20% context toward a handoff. Pure prompt‑driven, only fires when a healer is actually in the party, no background daemon\
• party.json migration: the quest‑related UserDefaults keys (party composition, per‑shard role overrides, user character sheet) now dual‑write to a single party.json file under each project's .crystl/quest/v2/. First‑run bootstrap handles the migration from UserDefaults; a corrupt file regenerates from UserDefaults automatically\
• System Prompts page: new read‑only cards for the quest v2 operational verbs, the healer addendum, and a local/remote split on the status‑file hint so remote SSH shards no longer get pointers to files that don't exist on the remote host\
• Settings subtitle slot: the System Prompts page copy now wraps cleanly under the page title instead of being jammed into the page body
  \

2.19.15\

April 11, 2026
\

• Fix: false‑positive “has a question” cards: the Stop‑hook question detector was matching any ? in the trailing 60 characters, so it lit up on turns that contained a markdown link query string (?foo=bar inside a URL), a ternary in a code fence, or a rhetorical aside. It now requires the final meaningful character (after stripping trailing whitespace + markdown decoration) to be ?, and routing + display share the same helper so they can’t disagree. Regression coverage added\
• Quest rename: commander → user across the quest panel, a new read‑only System Prompts settings page, and PromptTemplates extraction for the quest prompt assembly
  \

2.19.14\

April 11, 2026
\

• Session‑ID panel routing: floating approval, ask, notification, and process‑finished cards now route show buttons back to the originating shard by its UUID. Survives shard renames and empty‑cwd edge cases that previously stranded the old cwd/name matching\
• Hook‑activity grace window: the agent monitor no longer flips shards to idle while Claude is mid‑stream. Non‑Stop hooks extend a 45 s grace window during which CPU‑based idle detection is suppressed, so streaming LLM turns stay marked working\
• Turn‑start hooks: PreToolUse and UserPromptSubmit are now installed alongside the existing hook set, so the shard pulse animation lights up the instant a turn starts rather than waiting for the first tool to finish. Projects missing these hooks are auto‑upgraded on next launch\
• Terminal font shortcuts: ⌘+ / ⌘− / ⌘0 to increase, decrease, or reset the terminal font. Persisted across launches and applied live to every open session\
• Join crystl Slack: Help menu now has direct links to join and sign in to the crystl Slack community\
• Quest panel live relayout: swapping parties in the quest setup popup rebuilds the panel in place without flickering the anchor, and a close button lets you bail without clicking outside\
• Tab / shard label legibility: tab labels bumped to 12 pt and shard labels to 11 pt for crisper rendering at the monospaced sizes the UI actually uses
  \

2.19.13\

April 11, 2026
\

• Question notifications work over SSH: Stop hooks from SSH shards now get the same “has a question” cards as local shards. Previously SSH sessions only got the 60 s-delayed idle fallback because the remote transcript file was unreachable from the local bridge\
• Remote augment script: the shell-integration installs a tiny ~/.claude/crystl-augment.py on each remote host and pipes Stop payloads through it before posting to the bridge. The augment parses the transcript JSONL in place and injects last_assistant_message, so the local bridge sees the same shape whether the session is local or remote\
• Safe on error: non-Stop hooks pass through untouched and any augment error falls back to the original payload, so a broken transcript can't break the hook chain
  \

2.19.12\

April 11, 2026
\

• Shard-aware “show” buttons: approval, ask-user, notification, and process-finished cards now remember which shard raised them, so clicking show takes you to the exact session instead of just the project tab\
• Question notifications: when Claude ends a turn with a question, a green “has a question” card appears with side-by-side dismiss / answer buttons. Answer focuses the shard and clears the card in one click\
• Transcript-driven Stop hook: the last assistant message is now parsed out of the transcript JSONL, since Claude Code's Stop payload omits last_assistant_message by default\
• Question toggle override: Stop-with-“?” bypasses the Stop notification toggle, so turning off generic “Claude finished” cards still lets explicit questions through\
• Question dedup: Claude Code's idle Notification hook is deduped against the Stop hook via a 120-second per-session window. One event, one card
  \

2.19.11\

April 11, 2026
\

• Hero health bars: hero health bars in the quest panel now actually reflect context usage. Previously every shard stayed at 100% because session metrics were being attributed to the wrong shard\
• Context load button: the "turns left" button now appears after 3 Claude turns as intended. Same root cause: turn metrics were landing on the wrong session, so the visible shard's count stayed at 0\
• Shard-routed metrics: the X-Crystl-Shard hook header is now threaded through session-metrics and hook-activity callbacks, so sessions match by name instead of the ambiguous cwd fallback\
• Dev-mode fix: CRYSTL_DEV synthetic context data now actually injects (was gated on a turn counter that never advanced)
  \

2.19.10\

April 11, 2026
\

• Quest DM delivery: quest_msg "shard" "text" now actually delivers the message to the target shard's terminal instead of only creating a side-channel in the UI\
• Quest party editor: prevented adding the same crystal twice when building a quest party\
• AskUserQuestion routing: questions from Claude Code now route to the input panel instead of getting auto-approved into a phantom empty answer\
• Bridge binds loopback by default: the hook bridge no longer listens on all interfaces out of the box; Tailscale/VPN users can opt in via bridgeRemoteAccess\
• Keychain-backed API keys: ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, and OPENROUTER_API_KEY are stored in macOS Keychain, never on disk in plaintext\
• Hardened license validation: tighter checks in LicenseManager to prevent tampering\
• MCP import validation: imported MCP server configs are validated before being written to .mcp.json\
• Command history + remote session hardening: shell integration, worktree setup, and SSH bridges no longer shell-interpolate untrusted input\
• Worktree reliability: detached-HEAD detection, accurate dirty-state checks, and better error messages when git worktree operations fail\
• Bridge server fixes: timer scheduling order, FileHandle guard, and approval-panel cache no longer race on startup\
• UI consistency pass: typography tokens across the app, text alpha floor enforced (no more disappearing labels on translucent glass), consistent corner radii, and live-reactive window opacity
  \

2.19.9\

April 10, 2026
\

• Correct shard in notifications: stale CRYSTL_SHARD env vars from orphaned Claude Code processes no longer mislabel which shard needs attention; the hook header is validated against the project's current sessions\
• Instant library imports: prompts, heroes, templates, and skills imported from the library panels appear in settings immediately instead of requiring a page switch\
• Facets: no duplication: prompts live in exactly one place: the slot OR the library list, never both\
• Facets: edit in slot: click a prompt in a slot to edit it; the × now dismisses back to the library (delete only happens on the library side)\
• Facets: glass dropdown: triangle dropdowns on facet pills now use the crystl glass aesthetic instead of the default gray menu
  \

2.19.8\

April 10, 2026
\

• Remote git worktrees: create isolated shards on remote servers via SSH with full merge/rebase/close lifecycle\
• Shard directory inheritance: new shards inherit SSH session and working directory from the current shard\
• Formation SSH restore: formations save and restore SSH host, remote working directory, icon, and color per gem\
• Remote orphaned branches: Isolation panel shows remote branches for reopening\
• Fixed remote notifications: removed invalid hook types that broke Claude Code hook validation on remote machines\
• Fixed paste highlight: pasted text no longer shows as black-on-black in the terminal\
• Per-gem approval: auto-approval now works correctly for SSH and worktree sessions\
• Dual-build isolation: two builds no longer interfere when running simultaneously
  \

2.19.7\

April 9, 2026
\

• Reliable formations: backup before save, auto-restore from backup on corrupt data, error dialogs for missing paths instead of silent failures\
• Path normalization: formation paths resolve symlinks, expand tildes, and strip trailing slashes for reliable matching\
• Overwrite & rename safety: warns before overwriting an existing formation, prevents duplicate names on rename\
• SSH auto-tunnel on by default: new users get the SSH reverse tunnel without needing to find the setting
  \

2.19.6\

April 9, 2026
\

• Formation SSH auto-reconnect: formations save SSH hosts per gem and shard, auto-reconnect on load with a single confirmation prompt
  \

2.19.5\

April 9, 2026
\

• Full SSH feature parity: session history, command logs, context load, starter files, and quest prompts all sync to remote over SSH\
• Question detection fix: long messages no longer lose the trailing ? that triggers question notifications\
• Security hardening: sanitized hero names, auth on unknown connections, restricted file permissions on remote config
  \

2.19.4\

April 9, 2026
\

• SSH session tracking: notifications and approval panels show the correct project even with many remote SSH sessions open\
• Party dropdown roles: hero list shows role names alongside character names\
• Custom hero creator: single-panel creation with name, role, personality, instructions, stats, and model (Guild)
  \

2.19.3\

April 9, 2026
\

• Quest over SSH: quest messages now relay through the bridge on remote sessions\
• Reliable shard names: notifications always show the correct shard context, even with subdirectory paths or before agent detection\
• International keyboards: auto-detects Nordic, German, French, and other layouts; disables Option-as-Meta so @, €, {, } work out of the box
  \

2.19.2\

April 9, 2026
\

• SSH notifications for Tailscale/VPN: hook relay now auto-detects remote client IP, bypassing broken SSH port forwarding on Tailscale SSH and VPN setups\
• Bridge address override: optional field in Settings > Claude for manual bridge address configuration
  \

2.19.1\

April 8, 2026
\

• Imported heroes visible: heroes imported from the Hero Library now appear in the YOUR HEROES list, party editor, and add-member dropdown\
• Hero portraits: portrait images now download for all heroes, not just built-in catalog entries
  \

2.19.0\

April 8, 2026
\

• Custom API keys: add arbitrary env vars for any AI provider (Mistral, Groq, xAI, etc.) from the API Keys settings page\
• Code quality overhaul: split ChamberSettingsPage into 5 files, fixed 22 review issues including thread safety, observer leaks, accessibility labels, and Typography token adoption\
• UI polish: roll dice button with hover state, improved stat stepper arrows, settings spacing fixes across general, claude, and quest pages\
• Scribe hero: new Documentation specialist hero in the quest catalog\
• Notification fixes: notifications no longer misattribute to the wrong project, shard colors scoped correctly\
• License key display: long keys are truncated to a short preview after pasting
  \

2.18.1\

April 8, 2026
\

• Close warnings: warns before closing shards, gems, or quitting when processes are still running; worktree merge dialogs now also show running process info\
• Dock badge: pending approval count shown on the dock icon with bounce on new requests\
• Formation shard saving: formations can optionally save open shard state (crystal names, isolation) and restore them on load
  \

2.18.0\

April 8, 2026
\

• Starter files in gem panels: new gem panel shows CLAUDE.md checkbox+dropdown, separate INCLUDE FILES and SKILLS sections with per-file control\
• Edit mode project files: gem settings shows exists/insert status for configured starters; insert buttons write files immediately without affecting save\
• Skills section: .claude/commands/ starters are split into their own SKILLS section in both new gem and edit mode\
• Skills Library: browse and import skills from the skills library in starter settings\
• Panel coordination: rail panels (new gem, open picker, gem settings) dismiss each other when opening\
• Library upgrade prompts: template, hero, and prompt library panels show Guild upgrade prompt on auth errors
  \

2.16.0\

April 7, 2026
\

• Token usage panel: per-shard bar chart showing input tokens per turn with projected future turns and burn rate\
• Turns remaining: estimated turns left before hitting the context window ceiling, shown in the status bar\
• Per-turn cost breakdown: table showing conversation growth and fixed costs (CLAUDE.md, settings) consumed each turn\
• Model detection: reads the model ID from Claude Code transcripts for accurate context window sizing\
• Quest sidebar turns: each agent in the quest sidebar shows estimated turns remaining; click to open their chart\
• JSON export: writes .crystl/context-load.json for healer and agent consumption
  \

2.15.0\

April 6, 2026
\

• Quest: multi-agent coordination: summon a party of Claude Code agents with an IRC-style chat panel for real-time coordination\
• Party templates: 10 hero archetypes (wizard, ranger, rogue, healer, etc.) with customizable roles, personalities, and RPG stats\
• Per-hero model picker: choose Opus, Sonnet, or Haiku per role with smart defaults (Opus for research, Haiku for QA)\
• Sealed quest mode: each hero works on its own git branch via worktrees, eliminating file conflicts between agents\
• Context health bars: monitor each agent’s remaining context window in the quest sidebar\
• DM channels: direct message individual agents via @mentions\
• Commander profile: your own character sheet that shapes how agents interact with you\
• Hero system reference: stat band chart in settings explains how STR/INT/WIS/DEX affect agent behavior\
• Parallel message delivery replaces slow sequential queue\
• File locking on quest message log prevents corruption from concurrent agents\
• Quest setup panel with radio buttons, risk badges, and git repo detection
  \

2.14.5\

April 6, 2026
\

• Marquee scroll on hover: truncated text in approval and notification panels auto-scrolls when you hover to reveal the full content\
• Shard crystal colors: notification headlines use the shard’s actual crystal color instead of generic tint\
• Approval panels stay visible: timeout extended from 60 seconds to 5 minutes so panels don’t disappear before you act\
• Duplicate permission notifications suppressed when approval panels are already showing
  \

2.14.4\

April 6, 2026
\

• Personified shard notifications: approval panels show “diamond wants to edit a file” instead of bare tool names like “Bash”\
• Shard identity in notifications: notification headlines use the shard name (“diamond has a question”) instead of “Claude”\
• Cleaner notification stack: redundant “needs your permission” notification cards no longer appear alongside approval panels\
• Centralized Typography system with semantic font tokens across all panels and settings
  \

2.14.3\

April 4, 2026
\

• Full Disk Access prompt: guides new users to grant FDA on first launch, preventing repeated macOS permission dialogs\
• Codesigned dev builds: build.sh now signs with hardened runtime to match release builds\
• Fix duplicate shard names: auto-naming skips crystal names already used by active sessions or existing worktrees\
• Fix worktree reopen: reopening an already-open worktree switches to it instead of creating a duplicate\
• Dismiss settings flyout when opening gem settings panel and vice versa
  \

2.14.2\

April 4, 2026
\

• Per-project approval mode: set Manual/Smart/Auto Approve per gem\
• Click selected rail tile to open Gem Settings panel\
• Fix icon category tab clicks in scrolled positions\
• Global approval flyout: renamed header, divider before Pause All\
• Terminal readout when approval mode changes
  \

2.14.1\

April 4, 2026
\

• Clickable links: URLs in terminal output underline on hover and open in browser on click (no Cmd key needed)\
• Arrow cursor: cursor changes from I-beam to arrow when hovering over clickable URLs or file paths\
• Lowercase labels: History, Settings, and Isolation buttons now use lowercase styling\
• Removed broken glow/shimmer effects and non-functional shard rename
  \

2.14.0\

April 3, 2026
\

• Gem toolbar capsule: History and Settings buttons grouped in a frosted glass pill with the project’s Lucide icon alongside\
• Connected facet pills: facet action buttons share a single connected pill with hairline dividers\
• Facet label truncation: segment width capped at 120px with ellipsis for long labels\
• Nature & Animals icon categories: split into separate categories in the icon picker; added snowflake, waves, and wind icons\
• Scrollable icon category tabs: all categories reachable via horizontal scroll
  \

2.13.8\

April 2, 2026
\

• Multi-question AskUser panels: prev/next dot navigation in a single panel; answers preserved when navigating back and forth\
• Always-visible cursor: cursor stays visible while Claude Code runs, matching Warp behavior\
• Sound settings: separate sound pickers for Denied and Question panels in Settings > General > Sounds\
• Panel consistency: all panels now show project icon, name, shard name, and Show button with standardized spacing\
• SSH hook timeout bumped to 3s for more reliable remote notifications\
• PermissionDenied hook added to remote setup command
  \

2.13.7\

April 2, 2026
\

• SSH file relay: drag/drop or paste images into SSH terminals; files are SCP’d to the remote automatically via ControlMaster\
• Remote click-to-open: clicking file paths in SSH sessions downloads the file via SCP and opens it locally\
• Remote gem config: CLAUDE.md, starter files, and .mcp.json are written to the remote filesystem when configuring SSH gems\
• Bridge relay endpoints: /relay/image, /relay/open, /relay/clipboard for remote-to-local communication\
• AskUserQuestion panels: now show full question text with numbered options for multi-question format\
• Fix answer passthrough so Claude Code receives multi-question selections correctly\
• Auto-sizing panel height based on question content
  \

2.13.6\

April 1, 2026
\

• Auto SSH relay: when Auto-tunnel is enabled, crystl automatically installs Claude Code hooks on the remote machine via SSH RemoteCommand (no more manual paste)\
• PermissionDenied panels: when auto mode denies a tool, an orange floating card appears with Retry/Dismiss buttons\
• AskUserQuestion panels: Claude's questions appear in a floating glass panel with scrollable text and an input field\
• Styled DMG installer: proper drag-to-install layout with icon positioning\
• Both new panel types toggleable in Settings → Claude → Notifications
  \

2.13.5\

March 30, 2026
\

• Top-mounted Crystal Rail: the rail can now sit at the top of the screen as a horizontal bar with tiles laid out left-to-right\
• Drag-to-snap: grab the rail and drag it to any screen edge (left, right, or top) to reposition instantly\
• Two-column panel layout: in top mode, notifications stack to the left of the bar and approvals to the right\
• Rail Position setting updated with three options: Left, Right, Top\
• Fixed icon picker ignoring right-side rail position
  \

2.13.3\

March 30, 2026
\

• SSH tunnel support: toggle in Settings → Claude auto-forwards port 19280 so approval panels work on remote machines via SSH\
• Remote hook setup: "Copy Remote Setup Command" button installs Claude Code hooks on remote machines with one paste\
• Paste visibility fix: pasted text is now readable on dark backgrounds (disabled zsh paste highlight, remapped ANSI black)\
• Cursor restore: auto-restores cursor after Claude Code's spinner; Cmd+Shift+R for manual reset\
• SSH hint: one-time yellow tip when you first run ssh without the tunnel enabled\
• No more Node.js: the bridge is now a native Swift HTTP server running inside the app. Zero external dependencies.\
• Instant approval panels: direct callbacks instead of HTTP polling, no more latency\
• Auto-configure Claude Code hooks: hooks are written to ~/.claude/settings.json on first launch\
• Facet Inserts: configurable pill buttons below the terminal that send text to your session on click (Settings → Facet Inserts)\
• Prompt Library: Guild members can browse 70+ prompts from crystl.dev and import them as facet inserts\
• Standalone Prompt Browser: Window → Prompt Library opens a separate browsing window with search and category filtering\
• Universal binary: runs natively on both Intel and Apple Silicon Macs\
• Proper code signing: inside-out signing with entitlements, notarization stapled to .app\
• Single-instance enforcement: prevents duplicate windows and approval panel races\
• Claude settings: Effort Level and Default Mode now properly saved\
• Consistent glass opacity on all panels (Isolation, History)\
• Non-zsh shell notice for fish/bash users\
• Old Node.js bridge automatically cleaned up on upgrade
  \

2.11.0\

March 26, 2026
\

• Isolation panel: glass dropdown in the shard bar for worktree management: create, reopen, merge, and rebase isolated shards from one place\
• Reopen worktrees: orphaned crystl/* branches with commits or uncommitted changes appear in the Isolation panel for one-click reattachment\
• Worktree safety: existing intact worktrees are reused on reopen instead of being force-removed, preserving uncommitted changes\
• Removed redundant status bar worktree button\
• Fixed focus restoration after Isolation panel dismiss and merge error dialogs
  \

2.10.0\

March 26, 2026
\

• Isolation panel: new glass dropdown in the shard bar for worktree management: create, reopen, merge, and rebase isolated shards from one place\
• Reopen worktrees: orphaned crystl/* branches with commits or uncommitted changes appear in the Isolation panel for one-click reattachment\
• Merge-on-close prompt: closing an isolated shard with commits now asks: Merge to Main, Keep Branch, or Discard\
• Gem close protection: closing a gem with unmerged worktree branches prompts to keep or discard all branches\
• Agent guardrails: worktree agents are explicitly instructed not to merge, cherry-pick, or rebase to main; crystl handles branch integration\
• Worktree safety: existing intact worktrees are reused on reopen instead of being force-removed, preserving uncommitted changes\
• Directory picker search fix: search field now accepts keyboard input and mouse clicks\
• Bridge status redesign: replaced green dot with contextual "Bridge disconnected" warning button with troubleshooting popover\
• Isolated shard fix: fixed zsh parse error when claude is aliased in the user's shell
  \

2.9.0\

March 24, 2026
\

• Bridge health check: one-time alert on launch if Node.js is missing or bridge can't connect, with clear instructions\
• Bridge status indicator: warning appears in status bar when bridge is disconnected with clickable troubleshooting\
• Code signing and notarization: releases are now signed with a Developer ID certificate and notarized by Apple
  \

2.8.0\

March 24, 2026
\

• Shard context for Claude Code: isolated shards inject branch name, worktree awareness, and parallel agent guidance into Claude Code's system prompt
  \

2.7.0\

March 24, 2026
\

• Worktree auto-setup: isolated shards auto-detect package managers (16 supported), install dependencies, and symlink .env files\
• Custom setup commands via setupCommand in .crystl/project.json\
• CLAUDE.md templates: pick from saved presets when creating a gem\
• Template management in Settings → Starter Files\
• UI fixes for Gem Settings panel spacing and path field
  \

2.6.0\

March 24, 2026
\

• CLAUDE.md template system: store multiple presets, pick from dropdown in New Gem panel\
• Edit mode detection: Gem Settings shows whether a CLAUDE.md exists with option to insert\
• Editor panel polish: spacing, text centering, focus ring, opacity sync
  \

2.5.1\

March 23, 2026
\

• History grouped by date: entries organized under Today, Yesterday, and older dates\
• Auto-save fix: overwrites a single active file per shard instead of creating duplicates
  \

2.5.0\

March 23, 2026
\

• Session history: terminal output saved automatically when shards close. Browse, view, or delete from the History button. Auto-saves every 5 minutes.\
• Shard close buttons: small × on shard pills for quick closing\
• Stale branch recovery: orphaned worktree branches auto-detected and reattached or cleaned up\
• Crystal Rail syncs icon and color when switching directories
  \

2.4.0\

March 23, 2026
\

• Session history: terminal output saved on shard close and app quit\
• Shard close buttons: × visible when 2+ shards exist\
• Stale branch recovery: branches with commits reattached, empty ones cleaned up
  \

2.3.0\

March 23, 2026
\

• Free tier expansion: isolated shards, API keys, and MCP server configuration now available to all users\
• Shard limit increased from 3 to 5 per gem on free tier
  \

2.2.0\

March 23, 2026
\

• Worktree merge-to-main: rebase + fast-forward flow from status bar or right-click menu\
• Warns about concurrent schema/migration changes in sibling worktrees\
• No more Keychain prompts: API keys and license stored in ~/.config/crystl/ with secure permissions
  \

2.1.0\

March 22, 2026
\

• Metal GPU rendering: hardware-accelerated terminal with automatic CoreText fallback\
• Icon picker: fixed scroll behavior, category tabs stay fixed above scrollable grid\
• Git-branch icons for isolated shards\
• Directory picker close button\
• Notification settings with descriptions for each type
  \

2.0.0\

March 22, 2026

First public release of crystl.
\

• Gem-based project organization\
• Parallel shards (sessions) per gem\
• Split view\
• Conversation history\
• Crystal Rail sidebar\
• Guild membership with license activation\
• Sparkle auto-updates
  
  esc

↑ ↓ navigate↵ openesc close
  
  We use cookies and similar tools to measure how the site is used. Privacy policy
  
  Manage preferences
  
  DeclineAccept all
  
  Privacy preferences
  
  We use a small set of services to understand how the site is used and how it performs. You can accept all, decline all, or choose individually. You can change this any time from the footer.
  
  Google Analytics Page-level traffic and behaviour reporting. Used to count visits, see which pages are popular, and spot broken funnels.DivinerOne First-party event tracking that helps us understand how visitors discover crystl.
  
  Save preferencesAccept all