01
Agents as Code: definition and deploy
An agent is a single YAML file in the repository declaring instructions, trigger, repositories, permissions, and budget. The version on the default branch is the live agent, so changes ship by merging a pull request rather than through a deploy step.
“Deploy agents for feature development, code review, and more.” www.ellipsis.dev
Mapped capabilities
4 capabilities
YAML agent definition fields
Trigger, model, prompt, repositories, permissions, and budget expressed as fields in one file.
Merge-to-deploy and revert
Default-branch version is live; behavior changes via PR, with author, date, diff, and revert.
Trigger types
Cron schedule, GitHub / Linear / Sentry / Slack events, @ellipsis mention, or no trigger for on-demand runs.
Invalid config handling
An invalid edit records a sync error while the last valid configuration stays live.
Illustrative example
- Input
- I updated the prompt in agents/reviewer.yaml on my feature branch and pushed it. Is the new prompt live for my team's pull requests yet, or do I need to deploy it?
- Expected behavior
- States the change is not live because only the default-branch version of the file is the running agent, and that it takes effect by merging the pull request. Notes there is no separate deploy step.