Loops

`createLoop`

Create Loop

Create a Loop: a recurring AI recipe (prompt + style preset) that fires on a cadence (interval/cron/idle) against an optional target (a repo, Space, Studio app, or task), with a model, write policy,…

write

Arguments

titlestringrequiredThe loop's display name.
promptBodystringrequiredThe recurring prompt this loop's recipe runs.
archetypestringrequiredThe style preset: audit (idle + suggestOnly review), automation (cron/interval + write), digest (periodic summary), or outreach.
triggerobjectrequiredThe cadence: interval, cron, or idle.
targetobjectrequiredWhat the loop is bound to.
writePolicystringrequired'suggestOnly' sandboxes every run read-only (no write/commit/push: a report is the deliverable); 'write' lets a run act. This is the write CEILING; raising it later invalidates consent until the human owner reconsents.
iconographystringoptionalAn emoji or short glyph for the loop. Defaults to a generic icon.
descriptionstringoptionalA short description of what this loop does.
modelstringoptionalModel id to run with. Omit to use the native default.
budgetsobjectoptionalPer-loop guardrails enforced by the same gate every scheduled fire goes through.
concurrencyCapnumberoptionalMax in-flight runs for this loop at once. Defaults to 1.

Returns

The registry does not declare a return shape.

Ask for it

The Cloud routes these requests to this verb.

set up a loop that
make this run every day
automate this recipe
create a recurring check on X

Pair it with

The verbs that finish the job.