agi-cos
FAQ

Questions, answered plainly.

Including the ones with awkward answers. If something here is wrong or missing, open an issue and it gets fixed.

Is it really free?

The software is MIT licensed and every feature is in it. Nothing is held back for a paid tier. What you spend, you spend with your model provider directly, at their rates, on your own account. Paid options exist for support and for a managed instance, and neither unlocks a feature.

What does it actually cost to run?

Whatever your models cost, and nothing else. Idle employees are database rows rather than processes, so a company that is not working costs nothing at all — the cost driver is wake-ups, not headcount. If you point it at a coding subscription you already pay for, it spends that instead of money.

Do I need an API key?

No. You can drive a CLI agent you already subscribe to — Claude Code, Codex or the Gemini CLI today. That consumption is recorded as quota with no monetary amount, because a subscription produces no invoice line to reconcile against.

Can the AI just mark its own work as done?

No, and not as a matter of policy. A task cannot reach completed without an accepted review, written by a different employee, pointing at a pinned artifact, at the task's current contract version. It is a database trigger, so it does not care who is asking. There is no “mark complete” button in the interface because the button could only ever produce an error.

What stops it running up a huge bill?

Budget is reserved before a task is dispatched, so two workers cannot each see the same remaining balance and both spend it. Ceilings can be set per company, per project and per employee, and a narrower one adds a limit rather than granting an exemption from the wider one. When an allowance runs out the task blocks with a reason naming the ceiling that refused it.

Is my code sent anywhere?

Only to the model provider you configured, in the requests you cause. There is no telemetry, no analytics on your instance and no hosted control plane. The application runs on your machine against your database.

How is this different from an agent framework?

A framework gives you a loop and trusts what comes out of it. This gives you a company: employees with managers and permissions, work with versioned acceptance criteria, and a database that refuses to record work as finished without independent evidence. The interesting part is not what it can do — it is what it will not let itself claim.

Can I use it commercially?

Yes. MIT permits commercial use, modification and redistribution. You are responsible for your own compliance with the terms of whichever model providers you configure.

Do I need Docker?

For real use, yes — the runner is what isolates agent code. There is a local mode so a first run does not require it, but it executes commands on your machine with your privileges and no sandbox, and it says so loudly.

Which models can I use?

Any the provider serves. The model field is free text rather than a dropdown, so something released this morning works this morning. A model with no published rate still runs — its usage is recorded as pending with the tokens kept, for whoever holds the invoice.

Start a company this afternoon.

It runs on your machine, it costs what your models cost, and it will not tell you the work is done until something other than a model says so.