FAQ · 58 answers

Questions, answered plainly.

Everything people ask before they put a small app online and share it, from the first deploy to the last limit.

01

The basics

What it is and who it is for.

  1. A place to put the small apps your AI assistant builds and share them with other people. You deploy from your project folder, and Cohostly provides the hosting, sign-in, a database, AI model access, connections to Google and Microsoft, scheduled jobs and approvals, so you do not wire those together yourself.

    How it works
  2. Anyone who builds tools with Claude Code, Cursor, Codex or a similar assistant and wants teammates, clients or friends to use them. You do not need to be a full-time developer. The aim is that sharing a small app feels like sharing a document.

  3. No. You deploy straight from a folder on your computer. You can also deploy a .zip or a GitHub repo, but nothing requires Git.

    The deploy command
  4. Anything that can run a command or speak MCP. You can deploy with the cohostly command, or connect your assistant to the Cohostly MCP server and ask it to deploy for you.

    The MCP server
  5. Small, purpose-made tools: a team dashboard, a signup sheet, a client portal, a morning summary, an internal form. Apps used by a handful of people and quiet most of the day suit it best.

    Use cases
  6. Large, busy products and always-on systems. Apps sleep when nobody is using them, and a single run has a length limit. A big, high-traffic or multi-service system may fit another host better.

    Compare with other hosts
02

Deploying

Getting an app from your computer to a link.

  1. Install the command line with npm, sign in with cohostly login, start a tiny app with cohostly new, then run cohostly deploy. You get back an address. The quickstart takes about five minutes.

    Quickstart
  2. Node, Python and Go apps, and folders of plain web files. The starter templates cover static sites, Flask, FastAPI, Express, Go and Next.js. Supported versions are Node 16, 18 and 20 to 24, Python 3.9 to 3.13 and Go 1.18 to 1.29.

    Limits
  3. Not by hand. Cohostly drafts the settings from your code and asks you to confirm them. They live in a file called cohostly.json, which you can edit when you want more control.

    cohostly.json
  4. Node.js 20 or later, on macOS or Linux. Windows works through WSL2 for the snapshot and check commands. Docker is needed only for cohostly check, which builds your app locally to prove it works.

    Command line overview
  5. Yes. cohostly check builds the app on your machine the way the platform would, and the develop commands let you run it locally with the platform’s services.

    Develop locally
  6. Up to 10 minutes, with about 1 MB of build log. Folders such as node_modules, .git and .next are left out of the upload already, so leave out build output and large data files too.

    Builds and uploads
  7. The error names the reason, and a failed deploy comes with a ready prompt you can paste to your assistant with the whole log. The common causes are a missing secret, an app that listens on the wrong address or port, and a limit being reached.

    Troubleshooting
  8. Usually it listens on 127.0.0.1 instead of 0.0.0.0, ignores the PORT variable, or writes files to disk that do not last. The how-apps-run page lists the five facts that explain most surprises.

    How apps run
03

Sharing and access

Who can open what you put online.

  1. Choose who can open it with the share command or in the dashboard, then send the link. A new app starts with a guest list of one: you.

    The share command
  2. Five: private (only people you invite), account (everyone in your team’s account), signed_in (anyone with a Cohostly account), link (anyone with the link) and public. Pick the narrowest one that does the job.

    Sharing and roles
  3. A new app starts with only you on the list. You widen it when you are ready.

  4. Use cohostly share invite with their email. Someone who already has an account gets access at once. Anyone else gets an invitation that lasts 14 days, and has no access until they confirm.

    Invitations
  5. A viewer can open the app and see its versions. An editor can also deploy, promote, roll back, change settings and see logs. An admin can also change sharing. On an account there are owners, admins and members.

    Roles
  6. Within about 30 seconds. Access is checked on every request, at the edge, before a visitor reaches your app.

  7. A browser that is not signed in is sent to sign in. A script, or a signed-in stranger with no access, sees a plain "not found".

  8. Yes. Add a custom domain to an app with the domains command. A custom domain is also the right choice if you set up your own login provider, because the default address can change if the link is reset.

    Domains
  9. Yes, but choose carefully: Cohostly’s checks come first. For an app with its own sign-in, set visibility to public or link, otherwise visitors are stopped before they ever see your login page.

    An app with its own login
04

Safety and control

What keeps an AI-built app from going wrong.

  1. A checkpoint where a person says yes before something important happens. When an assistant deploys, the new version can wait for approval. Your own app can also ask a person to approve an action, such as deleting rows or emailing a list, before it runs.

    Approvals
  2. The people the account allows. Some requests, such as opening an app wider or raising a spending limit, are held until an account owner or admin answers, and deciding one requires being signed in to the dashboard.

    Who decides
  3. It expires, and an expired request counts as a no. Your app should treat every answer except "approved" as "do not do it".

    Callbacks and waiting
  4. In Cohostly’s secret store, never in your code, a chat or a settings file. You list the secret names in cohostly.json, set the values with cohostly secrets, and your app reads them from its environment.

    Secrets
  5. The value goes from your keyboard into the secret store and does not pass through the assistant. An assistant cannot add an AI provider key for the same reason: it would pass through the assistant.

    Bring your own key
  6. Yes. A connection can be set so every call that changes something, such as sending an email or editing a sheet, waits for a person to say yes.

    Holding writes for approval
  7. Yes. Every deploy is a numbered version. Promote an older one or roll back, and nothing is rebuilt, so it is quick. The newest 10 versions can be promoted.

    Versions and rollback
  8. Yes. The account keeps an activity log of changes, including ones made by an AI agent.

    The account
05

What comes built in

Services your app can use without setup. The docs call them bindings.

  1. A service Cohostly lends your app. You declare it in cohostly.json, and the platform gives your app an address and a token for it. The real keys behind the service never enter your app.

    Bindings overview
  2. Yes. The AI binding lets your app ask a language model a question without holding a provider key. A gateway checks the model, the rate and the budget on every call.

    The AI binding
  3. The platform pays for a small set of models. For others, such as the Claude models, you bring your own key from the company that makes them, and that company bills you directly.

    Models and costs
  4. Yes. Managed data is a small hosted SQLite database for each project. Your app never holds a connection string. Rules written above each table decide who can read and who can write.

    The data binding
  5. It is a small database, not a data warehouse: no joins through the data service, no multi-statement transactions, and one writer at a time. A read returns at most 1000 rows.

    Data limits
  6. Yes. A connection lets your app use someone’s Google or Microsoft account after they agree once on a consent screen. Your app never sees a password or a token. Slack is not available yet.

    Connections
  7. Your choice. In owner mode everyone acts through one connected account, such as the shop’s own sheet. In visitor mode each person connects their own account, and the app acts as that person.

    Owner and visitor mode
  8. Yes. The clock binding runs your code at times you choose, such as every weekday at 9:00, in the time zone you set. It records every run, retries failures and stops two runs overlapping.

    Scheduled jobs
  9. A sleeping app runs no code, so a timer inside it stops. The platform keeps the clock outside your app and wakes the app when a job is due.

    Why not setInterval
06

How apps run

What to expect once an app is online.

  1. After 10 minutes with no visits by default, it goes to sleep, and the next visit wakes it. The first visit after a sleep is slower, so open it yourself before showing it to someone.

    How apps run
  2. Not reliably. Files can disappear on a restart, a new version or a long sleep. Keep anything that matters in the managed database, which survives restarts and returns with the right version on a rollback.

    Data binding
  3. If the project is marked stateful, the command line can back up and restore its /data folder, up to 256 MiB. A backup is a safety copy, not a promise that the disk lasts.

    Backup and restore
  4. 512 MB by default, and you can choose 256, 512, 1024 or 2048 MB. The account has a limit on the total memory of apps awake at the same moment. A sleeping app does not count.

    Machines
  5. 0.0.0.0, on the port in the PORT variable. After a deploy the platform asks your health address until it answers, for up to 5 seconds by default.

    How apps run
  6. Yes, in the dashboard and from the command line, along with the version history to compare against.

    Limits and fixes
07

Limits and costs

The numbers, and what happens at the edge.

  1. At the moment: 5 projects, 2 apps running at once, 2048 MB of memory across running apps, 10 deploys an hour and 40 builds a day. The docs call these starting values that may change.

    Limits
  2. The message names the limit, says what your account has and how to raise it. A refused action is a 403, and at the web address itself it is a 429.

    Limits
  3. By default $2.00 per project per month and $10.00 per account. A call that would pass a cap is refused before anything is spent.

    Models and costs
  4. Rate limits apply at the edge: 600 requests a minute from one network address to one project, and 6000 from everyone. Only the address over its limit is refused.

    Limits
  5. Yes. The cost command and the dashboard show usage per app. Pricing is not set, so costs shown are estimates, and compute time and AI spend are not measured everywhere yet.

    Cost
  6. Pricing is not published yet, and costs shown today are estimates. Email us and we will tell you where things stand.

08

Account and contact

Keys, privacy and reaching a person.

  1. cohostly login shows a code, you approve it in the dashboard, and a key is handed over once. It is saved in a file only you can read. Scripts and CI use an API key that starts with plk_.

    Sign in and keys
  2. You sign in once in the browser and approve a consent screen. Access lasts 30 minutes and refreshes for up to 30 days.

    Sharing, sign-in and roles
  3. Shared secrets, AI provider keys, connections, API keys, the activity log, approval rights and usage.

    The account
  4. Apps, secrets and connected accounts belong to you. The privacy page describes exactly what the website and dashboard measure and what they never collect.

    Privacy
  5. At cohostly.cloud/docs, with a quickstart, every command, the SDK, each binding and sample apps.

    Read the docs
  6. Email hello@cohostly.cloud, or use the contact form on the home page.

Still have a question?

Write to hello@cohostly.cloud and a person will answer.

Put your app online