schedule agents
guild membershipSome work should just happen on its own — the overnight test triage, the morning inbox pass, the pre-standup release check. Schedule a fresh agent to launch at a set time, once or on a cadence, and crystl runs it without you lifting a finger.
A schedule launches a brand-new agent shard at a time you choose. It carries the same launch choices you'd make by hand — target gem, task prompt, agent, model, approval mode, and an optional isolated worktree — so the scheduled run is a full, real session, not a cron one-liner.
Pick the cadence that fits: once for a one-off reminder-with-hands, daily, or weekdays for the recurring passes. Times are interpreted in the time zone you set, so "9:00 AM" means 9:00 where you are. Point it at any gem, hand it a prompt, and walk away.
Create and manage schedules from the Settings → Agents → Schedules panel, or drive them from the crystl CLI — crystl schedule add, schedule list, and schedule cancel. Name a schedule, see what's upcoming, and edit or cancel it any time.
Why it matters
Once, daily, or weekdays
Fire a one-off at a specific date and time, or set a recurring cadence for the passes you run every morning or every weekday.
Time-zone aware
Set the IANA zone once and times mean what you'd expect — 9:00 AM is 9:00 where you are, not UTC, and daylight saving is handled for you.
A full session, not a cron line
Each schedule carries a real prompt, agent, model, and approval mode. When it fires, you get a proper agent shard picking up the task — not a bare shell command.
Pick the agent and model
Schedule Claude, Codex, or another agent, and pin a model version if the task needs it — the same choices you'd make spinning a shard up by hand.
Isolated worktree option
Flip on an isolated worktree and the scheduled run lands on its own branch — safe for anything that edits files while you're away.
Settings panel or CLI
Create schedules in the Settings → Agents → Schedules panel, or script them with crystl schedule add / list / cancel. Reading and listing are free; creating one is a Guild action.
Ready to try it?
Create a free account and download crystl for macOS.
get started getting started guide →Frequently asked questions
- How do I schedule an agent?
- Two ways: the Settings → Agents → Schedules panel, or the crystl CLI — crystl schedule add --gem
--at "09:00" --every weekdays --prompt "...". Use crystl schedule list to see what's queued and crystl schedule cancel to remove one. - What recurrence options are there?
- Once (a one-off at a specific date and time), daily, or weekdays (Monday–Friday). Times are interpreted in the IANA time zone you set, with daylight saving handled for you.
- What can I configure per schedule?
- The same choices as launching a shard by hand: target gem, task prompt, agent (Claude, Codex, and others), model, approval mode, and an optional isolated worktree. You can also give the schedule a name so it's easy to find later.
- Is scheduling free?
- Listing schedules is free on every tier. Creating and cancelling a schedule is a Guild action, like other commands that change state.
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.
Agent Activity Panel
One live view of every agent across all your gems — who's working, who's idle, and where tokens are going.
Parallel Sessions
Run multiple Claude instances on the same repo without conflicts.
Hero Shards
Summon a single hero as a shard — its own agent, model, and persona — without a quest party.
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.
Markdown Editor
Render and edit any .md in a side panel — toggle it from the workbench, and let agents open docs for you from the CLI.
Prompt Integration
Facet Inserts give you one-click access to saved prompts, commands, and shortcuts.
Agent File 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.
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.