Skip to main content
Every space has exactly one agent, a logical identity defined by pages in its space:

Schedules

Schedules live in task frontmatter (schedule, scheduleTz, scheduleEnabled) and are edited from the task page’s Schedule card.

Execution authority

  • Scheduled runs execute as the space agent principal: write access in the home space, read-only on org-visible spaces, and no access to other private spaces.
  • Manual runs execute with the requesting user’s authority.

Driving agents programmatically

Tasks, runs, and instructions are all addressable outside the app.

From a terminal

coco agent task put, coco agent run --watch, and coco agent runs.

From code

coco.agents.createTask(...) and runTaskAndWait(...).