Hero Shards

Summon one hero as a shard: a solo specialist with its own agent, model, and persona. No party, no quest, just the right specialist for the task in front of you.

works withany CLI agentclaude codecodexantigravity cli

A hero is a saved agent persona — a role (UI/UX, Backend, Reviewer, QA), a personality, stat modifiers, and a system prompt, paired with its own agent and model. Until now, heroes lived inside crystl Quest: you summoned a whole party that coordinated in a shared chat.

Hero Shards let you summon just one. Click the summon-a-hero button next to the shard + in any gem, pick a hero from your roster, and it opens as a standalone shard — its own agent, model, and persona — ready to work. No party to assemble, no chat to manage.

Flip the isolated (own git worktree) toggle and the hero works on its own branch in an isolated shard, so it never collides with your other sessions. It's the lightweight path: when you don't need a full Quest, you reach for the one specialist that fits.

You don't even need the panel. With the crystl CLI enabled, your agent can spawn hero shards for you — just ask it to summon the heroes you want on the models you want, and it does the rest.

Why it matters

Summon a solo specialist

Pick a hero — Wizard (UI/UX), Rogue (Backend), Bard (Reviewer), Monk (QA), and more — and it opens as a shard with its own agent, model, and persona already applied.

One click from the shard bar

Launch from the summon-a-hero button right next to the shard +. No party setup, no quest panel — a specialist shard in a single click.

Optional isolation

Toggle isolated and the hero gets its own git worktree and branch, so it can work in parallel without touching your other shards' files.

Your whole roster, solo

Every hero you'd add to a Quest party — plus local project heroes — is available to summon on its own. Same specialists, no party required.

Dive deeper in the Hero Shards docs

Ready to try it?

Create a free account and download crystl for macOS.

get started getting started guide →

Frequently asked questions

How is a Hero Shard different from a Quest?
A Quest summons a party of heroes that coordinate as peers in a shared chat. A Hero Shard summons a single hero as one standalone shard — no party, no chat orchestration. Reach for a Hero Shard when you just need one specialist.
How do I launch a Hero Shard?
In any gem, click the summon-a-hero button next to the shard + in the shard bar. Pick a hero from the grid and it opens as a new shard.
What does the hero bring to the shard?
Its own agent, model, and persona — the role, personality, stat modifiers, and system prompt the hero is configured with. The shard starts already set up as that specialist.
Can a Hero Shard run isolated?
Yes. Toggle isolated (own git worktree) when you summon, and the hero gets its own worktree and branch — the same isolation as any isolated shard.
Where do the heroes come from?
Your hero roster — the same one Quest uses — plus any local project heroes defined in .crystl/heroes/. Browse the hero catalog in the Library.
Can my agent summon hero shards for me?
Yes. With the crystl CLI enabled (a Guild feature), ask your agent to summon specific heroes on specific models and it spawns the shards for you — no panel needed. The exact commands live in the CLI reference.
Book of Spells
the crystl guild

Crystl's Book of Spells

Master crystl with a grimoire of powerful prompts. Summon heroes, assemble a party, revive shards, and complete epic quests.

open the book →

More features

Gems & Shards

Gems, shards, and the Crystal Rail keep every project one click away.

Action Panels

See what every Claude session is doing at a glance.

Parallel Sessions

Run multiple Claude instances on the same repo without conflicts.

History Navigator

Browse, jump through, and search every session: conversation and tool calls.

Token Tracking

Track token burn per shard, estimate turns left, and reclaim context window by disabling heavy plugins and skills.

Workbench

A slide-out task list in every project, backed by a WORKBENCH.md the agent reads and writes with you.

Prompt Integration

Facet Inserts give you one-click access to saved prompts, commands, and shortcuts.

Agent Config Editor

Create, edit, and manage CLAUDE.md, rules, skills, and agent config files with a block editor, file chooser, and project optimizer.

Project Optimizer

Scan your project for gaps in agent configuration (missing files, incomplete docs, oversized code, and setup issues) with one-click fixes.

Starter Bundles

New gems launch with CLAUDE.md, rules, skills, and MCP config, all pre-configured from your bundle library.

Skills Library

Browse and import agentic skills that teach agents like Claude Code or Codex new tricks: code review, testing, deployment, and more.

Cavrn

The terminal as structured data: every turn, tool call, result, and table captured as agent-readable metadata. Drawn fast on the GPU with Metal.

Remote Development

Full crystl integration over SSH: approval panels, file relay, and click-to-open on remote machines.

Agent Orchestration

One agent spawns, supervises, and merges the work of many: a control room for a team of coding agents.

crystl Quest

Assemble a party of specialized agents. Each brings unique skills, coordinates in shared chat, and executes in parallel.

Screenshot Bar

Drag recent screenshots into the terminal. Spotlight-powered, always up to date.

Copy Bar

A one-click copy bar under the terminal. Agents stage text, you click Copy. Editable, up to 10 tabs, free.