What building an agent means
An open source AI agent framework usually gives you a library and the pieces to wire together, and the application that runs them is yours to write. On Kortix, you describe the agent as a file and let the platform run it. In Kortix, an agent is a markdown file at agents/<name>.md that holds its prompt and a scoped reach into tools, plus an agents.<name> block in kortix.yaml that carries its governance. The platform supplies the harness, the sandbox and the review path, so your work is the agent's instructions and its reach.
From an empty directory to a running agent
The quickstart runs five steps. Install the CLI, and kortix init my-agent scaffolds a project with kortix.yaml plus starter agents, skills and runtime config. kortix ship validates the config, commits, pushes and brings the project live in the cloud. kortix sessions new starts a session, one unit of agent work on its own cloud computer and its own branch. The code panels on this page carry the exact commands for each step, from install through the change request.
What each agent needs
Four things turn a prompt into a working agent: connectors, memory, triggers, and permissions. Connectors reach 3,000+ apps in a click, plus MCP, OpenAPI, Postman, GraphQL and raw HTTP, and connector credentials are brokered server-side and never enter the machine. Company memory is plain files today that accumulate as the agent works. A trigger is a cron schedule or a signed webhook that starts a session with no person present. Access is per resource for people and agents, with roles, groups, and an audit trail. Every action is recorded. Each connector action is set to Allow, Ask or Block. An Ask holds the call until a person approves it, then the agent resumes.
Where the change lands and who reviews it
Session work reaches main through a change request, and merge is default-deny for agents. The agent commits, pushes its session branch, and opens the change request against the project's default branch; a person with the project.gitops.merge permission reads the diff and merges it. Each session runs on its own isolated machine and branch, so thousands can run in parallel without touching each other. The patterns that make that handoff reliable are covered in building reliable AI agent workflows, and the runtime a session uses is covered in running an agent framework.
How to self-host
Kortix runs on Kortix Cloud, in your VPC, or on your own on-prem network, and self-host is free. After installing the CLI, kortix self-host start brings up the full stack on your own box as one Docker Compose stack. The Kortix docs and Kortix on GitHub cover the rest.