Introduction
HeadlessOps — the AI-native automation platform for developers
Welcome to HeadlessOps
HeadlessOps is an AI-native automation platform that lets you build, deploy, and run deterministic business automations using TypeScript scripts and a simple YAML manifest.
Automations (called integrations) run inside isolated TypeScript V8 isolates and are triggered by webhooks, schedules, or manual API calls. Agents interact with the platform through a full REST API and a native MCP server.
What You Can Build
- Webhook automations — receive HTTP events and process them in TypeScript
- Scheduled jobs — cron-based recurring automations
- Manual triggers — on-demand runs via API or the web app
- AI agent workflows — let LLMs write and deploy automations via MCP
Core Concepts
| Concept | Description |
|---|---|
| Workspace | Isolated tenant environment containing integrations, credentials, and data stores |
| Integration | A named automation composed of a YAML manifest and TypeScript step files |
| Step | A single async TypeScript function (async function run(input, ctx)) in the pipeline |
| Trigger | How an integration is invoked: webhook, schedule, or manual |
| Run | A single execution of an integration, with full step logs and status |
| Credential | A named secret (API key or OAuth2 token) stored in the workspace vault |
| Data Store | A managed key-value / relational table for persisting state between runs |
| Knowledge Base | Workspace-scoped Markdown documents for agent and developer context |