Get started with Swirls
Swirls provides the managed backend for your business software. Define workflows, agents, data, connections, and access rules in .swirls files, then validate locally and deploy to Cloud.
Build the interface that fits your business: a React app, a Node.js service, your own API, or an MCP server for ChatGPT and Claude. Your application calls Swirls behind the scenes. You can also use a hosted Swirls App for pages, chat, and workflow reviews.
For direct calls from an external assistant, managed MCP channels can host selected workflow tools and agent conversations for you.
See how to build apps with Swirls →
Your first deployment
Install the CLI, create a project, validate your files, and inspect the deployed system in Cloud.
From source to running system
Learn how projects, deployment snapshots, managed resources, and hosted execution fit together.
The platform
Understand what Swirls manages, where your code runs, and how to operate a deployed project.
Projects & deployments
Source files, immutable snapshots, active deployments, Git integration, and rollback.
Managed infrastructure
Execution workers, isolated code, agent sandboxes, persistent storage, credentials, and networking.
Execution & operations
How work starts, checkpoints, waits, and recovers. Test with playbooks and inspect runs through traces.
The primitives
Primitives are the building blocks of a .swirls project. Each declares part of the system; the platform connects and runs them together.
Agents
Model-driven reasoning with tools, skills, persistent sessions, and chat channels.
Workflows
Explicit steps and data flow, started by triggers, with branching, waits, and human reviews.
Memory
Structured records, views, managed databases, existing Postgres, and persistent files.
Connections
Secrets, credential profiles, OAuth connections, typed API actions, and private networks.
Access
Identity-derived roles and policies that control who can invoke agents and workflows.
Interfaces
Hosted apps that bring pages, data, chat, and workflow reviews into a workspace.
See how the primitives fit together →
Keep building
- Build apps with Swirls — connect your frontend, API, or MCP server to the backend.
- Local development — install, configure, and validate.
- Set up with a coding agent — use the guided setup prompt.
- Testing — playbooks, mocks, and assertions.
- Traces — inspect runs and diagnose failures.
- Language reference — syntax, embedded code, and resource references.
- CLI reference — commands and flags.
- SDK reference — use the platform from TypeScript.
- API reference — authentication and API discovery.