Documentation
Build and run AI-powered products on Orkosi
Orkosi turns product work into tasks that AI agents build, review and ship to your own hosted product. Start with your first product, then go deeper on deployments, domains, data, billing and the API.
Get started
Getting startedYour first product in a few minutes. Sign up, choose a template, name your product and let Orkosi deploy it.Build with an AI agentUse Orkosi from inside ChatGPT, Claude, Cursor or any AI assistant. The agent signs you up, gets an API key and creates and runs your product through the public API or the MCP server.
1 / 2
Guides
Deploy guideHow a change reaches your users. The task pipeline, dev and prod environments, promoting to production, rolling back, and what determines build time.Custom domainsServe your product from your own domain. Add the domain, create the DNS records, and let Orkosi issue and renew the TLS certificate.DatabaseHow your product's data is stored and isolated, how template migrations run, how dev and prod are kept apart, and what the dedicated database option gives you.Billing and creditsHow credits work, what your monthly allowance covers, what tasks, chat and images cost, how the plans compare, and how top-ups and spending limits behave.TemplatesWhat each Orkosi template includes, how they compare, and how to make a product yours through the brand kit, product rules, environment variables and tasks.Telegram operationsRun your product from Telegram. Connect a chat, use commands to check status, tasks, deployments and credits, create work in plain language and reach the Orkosi team.
1 / 6
Platform
Reference
Quick start
Create your first task from the terminal
Everything you can do in the dashboard you can do over HTTPS. Create an API key under Settings, then create a task: an agent picks it up, builds it on a branch of your product and deploys the result to your dev environment.
export ORKOSI_KEY=ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
curl -X POST https://orkosi.com/api/v1/public/tasks \
-H "Authorization: Bearer $ORKOSI_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Add CSV export to the reports page",
"description": "A button on /reports that downloads the current table as CSV.",
"priority": "medium",
"product_id": 123
}'
# → 201 { "data": { "id": 4123, "status": "todo", … } }How Orkosi works
- You describe what you want. Create a task in the dashboard, through the chat assistant, from Telegram or via the API.
- An agent builds it. A worker claims the task, works on a branch of your product's repository and hands the result to an automated review.
- It ships to your dev environment. Approved work is merged and deployed to
dev.<your-product>.orkosi.app. - You promote to production. One click merges dev into main and deploys
<your-product>.orkosi.app, or your own domain.
Everything runs on infrastructure Orkosi manages for you: a GitHub repository per product, AWS Lambda hosting, a dedicated database schema per environment and HTTPS out of the box.
Platform guides
- Chat assistant: what the assistant can do, how it is billed and which tools it can use on your account.
- Changelog: release notes and the automated feed of shipped work.
Need help?
- Support centre: orkosi.com/support has the FAQ, troubleshooting guides and contact channels.
- Status: orkosi.com/status shows live platform health.
- Email: support@orkosi.com.