SWIRLS_
Platform

Platform

Author .swirls files locally, then deploy them to Swirls Cloud.

Your .swirls files define what your agents do. You can write and validate them locally, then deploy them to Swirls Cloud.

Deployment options

  • Local authoring: Write .swirls files locally, validate them with the CLI, generate types, and deploy for free to inspect the compiled project. See Local Development.
  • Swirls Cloud: The managed runtime for hosted execution. Auto-scaling workers, the dashboard, verifiable audit chain, and versioned deploys. Deploy with git push or swirls deploy. No CI/CD required. See Swirls Cloud.
  • Enterprise deployments: On-premise and customer-VPC options are available on the Enterprise plan. Contact us to talk through requirements.

Hosted execution model

When hosted execution is enabled and a trigger fires, the platform executes the attached workflow. Nodes run in topological order. Each node's output is checkpointed before the next node starts. If execution is interrupted, it resumes from the last completed checkpoint.

Trigger fires → Workflow executes → Nodes run in order → Outputs checkpointed → Audit log updated

Plans

The free tier is inspection-only: author locally, deploy, and inspect the compiled project in the dashboard. Paid plans add hosted execution metered in credits, from solo builders up to enterprise deployments with platform-managed keys. See Billing for how credits and metering work, and swirls.ai/pricing for current plans and prices.

On this page