CLI

CORAL provides a single coral command with subcommands grouped by purpose.

coral <command> [options]

Run coral --help for the full command list, or coral <command> --help for details on any command.

Command groups

Getting Started

• coral init — Scaffold a new task directory
• coral validate — Test your grader against seed code

Running Agents

• coral start — Launch agents on a task
• coral resume — Resume a previous run
• coral stop — Shut down running agents
• coral status — Show agent health and leaderboard

Inspecting Results

• coral log — List and search attempts (leaderboard)
• coral show — Show details of a specific attempt
• coral notes — Browse shared notes
• coral skills — Browse shared skills
• coral runs — List all runs

Dashboard

• coral ui — Launch the web dashboard

Agent Internals

• coral eval — Stage, commit, and evaluate changes
• coral diff — Show uncommitted changes
• coral revert — Undo the last commit
• coral checkout — Reset to a previous attempt
• coral heartbeat — View/modify heartbeat actions

See the full reference for all flags and examples.