coral-quickstart

# CORAL quickstart **CORAL** is infrastructure for autonomous coding agents: you give it a codebase (`seed/`) and a grader (turns a commit into a number), and it spawns agents in isolated git worktrees that edit code, submit commits, and get scored on a shared leaderboard — looping to push the score up. The agents *are* the optimizer; your grader defines "better". ## When to reach for CORAL **Good fit:** - You can express success as a **number** — accuracy, runtime ratio, pass rate, or a rubric-judge score for open-ended work. - The work is **iterative search**: many attempts at one well-scoped problem (kernel/algorithm optimization, benchmark solving, prompt/program tuning, "make this function faster"). - You want **parallel agents** exploring independently and sharing what works. **Not a fit:** - One-shot tasks with no measurable objective. - Work that needs a human judging every attempt (use a rubric-judge grader if a *model* can score it). ## How a run is shaped ``` you provide: seed/ (starter code) + a grader (commit → number) coral spawns: N agents, each in its own git worktree each agent: edit code → `coral eval` → grader scores it → read leaderboard → repeat shared state: attempts, notes, and skills are visible across agents in real time ``` Two things you build (`seed/` + grader) and one thing you tune (how many agents, which model). Worktrees, scoring daemon, shared state, and restarts are handled for you. ## Get running — four steps ### 1. Install...