Roar AI

View saved version →

---
name: build-and-change-apps
description: Build an app with the person and put it online with Roar AI, change an app that is already online, give it AI, or limit what it spends. Use when the person asks to make, deploy, update or fix an app or website on Roar AI.
---

# Build and change apps on Roar AI

Roar AI puts an app online from the files written in this chat and runs it. No GitHub account, server or ZIP file is needed.

## Build a new app

1. Ask only what the job needs. For a website: what the business is called and what it does. For a chatbot: what the business does and what people usually ask.
2. Agree in a few lines what the app does, then write it. Keep a first app small.
3. Put it online with `deploy_app_from_files`. The answer gives the app's `appId`: keep it for every later step.
4. Call `get_deploy_status` with `waitSeconds` until it is live, then share the link. Pass on in one line what its `nextStep` says the app can have next.

## Change an app that is already online

Never ask the person to connect GitHub or upload a ZIP for an app that was deployed from files. Its files are on Roar AI.

1. Find the app with `list_apps` if you do not have its `appId`.
2. If its files are not in this chat, call `list_app_files`, then `read_app_file` for each file you will change.
3. Send only the files that changed with `update_app_files`. Every other file stays as it is.
4. Call `get_deploy_status` with `waitSeconds`, then share the link.

Use `update_app_files` for a change. `deploy_app_from_files` always makes a new app with a new address.

If a change is refused because a deploy is already running, call `get_deploy_status` with `waitSeconds` until it finishes, then send the change again.

An app that deploys from a GitHub repository is changed by pushing to that repository.

## Give an app AI

Every app on Roar AI already has its own key. The app reads it from `ROAR_API_KEY`, and the endpoint from `ROAR_BASE_URL`, which is OpenAI-compatible. `list_models` gives the model names.

- Do not create a key for an app hosted on Roar AI.
- Never put a key in the code or in the chat.
- Call the models from the app's server code, not from the browser.

## Limit what an app spends on AI

Use `set_app_ai_budget` with the app's `appId` and a monthly amount in USD. The app's AI calls stop when the month's spend reaches it, and start again the next month. `get_app_ai_budget` shows the current limit.

You can set a first limit or lower one. Raising or removing a limit is done by a person in the Roar AI console, under API keys.

Do not create a new key to carry a limit: the app would not use it.

## When a deploy fails

`get_deploy_status` says what went wrong. `get_build_logs` has the detail. Fix the files and send them with `update_app_files`.

## Keep it simple

- Short messages, plain words.
- No prices, credit or offers.
- Share the live link whenever the app changes.

View saved version →

---
name: get-started
description: Show what Roar AI can do and start a first job. Use when the person sets up the Roar AI plugin, asks what they can do with Roar AI, or asks how to get started.
---

# Get started with Roar AI

Tell the person what Roar AI does in a few lines, ask one question, and get them to a first result.

## 1. Find out where they are

Call `get_started`. It returns what Roar AI is (`about`), what this account already has (`account`), what to do about the account's name (`setup`), and the question to ask (`next.ask`).

## 2. Say what it does, then ask one question

In two or three short lines, in your own words, say what `about` says. Then ask `next.ask` exactly as `get_started` returns it. The wording can change, so always use the one in the response.

Ask nothing else, and do not turn it into a list to pick from. Do not ask for the person's name or their company's name as a separate step.

If `account.apps` is more than zero, add one line saying they can also ask you to change an app they already have.

## 3. Save the business name from their answer

Follow `setup`. If the workspace has no name yet and the person tells you what their business is called, save it with `set_up_account` (`company`). If they are on their own and give their name, pass it as `fullName`. Use only a name they told you. If they gave no name, carry on and do not ask for one.

If `set_up_account` says the account is already set up, carry on. Do not try again or try another way to rename it.

## 4. Build what they asked for

- If they described a business and nothing else, build a one-page website for it.
- If they described a thing they want, build that.
- If they already have an app, put it online.

Keep a first app small, so it goes live in this chat, and share the live link. The `build-and-change-apps` skill has the steps.

## Keep it simple

- Short messages, plain words. The person may not be a developer.
- No prices, credit or offers.
- One question at a time, and only what the job needs.