cones.

Jobs and configuration

~/.cones/jobs.yaml holds dashboard settings and scheduled jobs. The dashboard's config screen and job wizard edit the same file, and cones config set KEY VALUE changes one setting. Every field: jobs.md.

A job

version: 4
defaults:
  timeout_min: 15
jobs:
  - name: nightly-triage
    schedule: "0 2 * * *"
    cwd: ~/src/myrepo
    prompt: "Read the TODOs and draft TRIAGE.md."
    model: sonnet

Jobs can run Claude Code or Codex. A Codex job also needs codex_full_access: true, because Codex runs unattended only with its sandbox lifted. A job naming any other harness is refused when the file is read.

FieldDefaultMeaning
schedulerequiredFive-field local-time cron.
cwd, promptrequiredWorking directory and task.
timeout_min30The only run limit. There is no dollar or turn cap.
overlapskipskip, allow or replace while a previous run is alive.
catch_upskiponce runs one missed tick at login.
notifyfalsemacOS notification when a run fails, times out or ends asking for input.
env[]Shell variable names to pass into the cleared environment.

What a job is allowed to do

A job is a scheduled launch of the agent you run by hand. It reads your settings, loads your MCP servers, answers no prompts and keeps every tool. cones adds no allowlist, no sandbox and no second permission engine; timeout_min is the only limit. Give a job a directory whose blast radius you accept.

GuaranteeClaude Code argumentsCodex arguments
Session you can open while it runs--bg--remote <daemon> -C <cwd>
Unattended--dangerously-skip-permissions--dangerously-bypass-approvals-and-sandbox
Job name--name <job>None; titled by its prompt
Model--model <m>-m <m>
Task-- <prompt>-- <prompt>

Schedules

Saving a job installs a per-user launchd agent, local.cones.<name>. launchd coalesces ticks missed during sleep into one launch on wake; it does not wake the Mac. Ticks missed while powered off or logged out are lost unless catch_up: once is set. These are launchd's documented semantics; sleep, reboot and login have not been verified by the project's checks.

A run's clock counts only time the Mac is awake.

Results

While a run works, its session is a live agent in the dashboard; enter joins it. The run ends the session when it ends, and the conversation stays resumable from the run row.

StatusWhen
okThe harness reported the session done.
inputThe session ended its turn asking for input. It stays up to answer. Codex runs never end this way.
skippedDisabled, overlapping, or a replacement that could not be confirmed.
timeoutThe clock ran out, or a later run replaced this one.
stoppedYou stopped it, or the session ended by other means.
failedThe harness reported failure, or launch or supervision failed.
crashedNo final record more than five seconds past the timeout.

A reported ok means the harness said the session finished. It does not establish that the code is correct.