2501 resources syncs a directory of MDX files with your platform. Each kind has its own subdirectory; each file declares one resource with YAML frontmatter (and a body where the kind has long-form text).
For the full reference, examples, and the resource file format, see Configuration as Code.
2501 resources pull
Export the platform’s current state into a local directory.
pull is a true mirror: existing .mdx files in each kind folder are removed before writing, so deletes on the platform also disappear from your repo. Commit the result for an exact snapshot.
Credential secret values are never exported — only the metadata.
2501 resources sync
Apply the directory back to the platform.
sync prints a plan (create / update / delete / unchanged) and applies in dependency-safe order. Stops on the first failure; resources already applied stay applied — re-run to continue.
Deletes are opt-in
By default, resources on the platform that aren’t in your directory are reported, not deleted. To prune them, pass --prune:
A prune that would orphan dependents (a host with active tasks, a specialty referenced by agents) is flagged BLOCKED and skipped. To override, add --force:
--prune --force removes resources even when they have dependents. Review the printed plan carefully before approving.
CI usage
Scope to one organization
Always pair pull --org with sync --org so the two operations cover the same scope.
Supported kinds
| Kind | Subdirectory | Body |
|---|
| Agents | agents/ | — |
| Hosts | hosts/ | Host knowledge |
| Specialties | specialties/ | Specialty prompt |
| Operational Rules | operational_rules/ | Rule text |
| Credentials | credentials/ | — (secrets via ${ENV}) |
| Gateways | gateways/ | Inbound prompt |
| Blacklist | blacklist/ | — |
