schedule agents

guild membership

Some 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.

works withany CLI agent

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 ordinary in-repo edits land on the scheduled run's own branch 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. Free up to 3 schedules on every tier; Guild lifts the cap.

Dive deeper in the Agent Scheduling docs →

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?
Yes — up to 3 active schedules on every tier. Create, list, and cancel them from the desktop, CLI, or phone. Past three, a Guild membership lifts the cap.

further reading

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 agent 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 in separate git worktrees.

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.

Open Models

Run open models locally or hosted, orchestrate them with frontier agents, and cut token costs.

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.