Building on Mecatl

Build on Mecatl when you want to embed the agent loop, integrate a client, or run agents as services on infrastructure you control. Mecatl provides an importable Go engine, remote APIs, a standalone server, and a Kubernetes deployment.

Choose where to start

• Build your first agent to embed the Go engine in a small application.
• Use the TypeScript SDK to connect a Node.js, Bun, or browser application.
• Pick a deployment to compare the embedded engine, mecated, mecak8s, and mecatequi.
• Try Mecatl on Kubernetes to run two mecak8s replicas in a local Kind cluster.
• Run the offline demo to see an engine turn without a model provider account.

Explore by topic

• What Mecatl provides explains the engine, session model, agent loop, tools, permissions, hooks, and other built-in capabilities.
• TypeScript SDK covers application connections, sessions and runs, approvals, durable activity, and callback tools.
• Extension points covers the Go ports for model providers, storage, permissions, tools, and other adapters.
• Deployment guides cover embedding the engine, operating mecated or mecak8s, using mecatequi in CI, and connecting remote clients.
• Cloud-native architecture explains how Mecatl separates the agent process from durable state and execution.
• API stability identifies the supported Go packages and compatibility guarantees.
• Reference provides exact configuration fields and gRPC and HTTP/SSE contracts.