Plans, limits and billing
This page is for whoever looks after an organization's plan: its owners, its admins and the person who pays. It shows where to see what your plan includes and what you have used, what happens at each limit, and how paying works.
The plan belongs to the organization, not to a workspace or a person. Every workspace in the organization shares it. There are four plans: Community, Pro, Team and Enterprise. The plans page compares them side by side.
Before you start
- Who can see it: everyone in the organization can open Settings ▸ Billing and read the plan and the meters.
- Who can change it: the organization's owners, admins and its Billing role. Only they see the buttons that open the payment pages. See Invite people and choose their roles.
- A personal organization has a plan too. It is yours alone.
Your plan and what you have used
Open Settings ▸ Billing. The page shows your plan's name under Your plan, and a line about its state, such as This period ends … or Paid until ….
Under This period is one row for each thing your plan counts. Where your plan has a limit, the row has a bar and says how much you have used of it, such as 2 of 3. Where the plan sets no limit, it says how much you have used and unlimited. Storage and a row your plan doesn't include show only the count.
| Row | What it counts |
|---|---|
| Seats | People in the organization who aren't guests |
| Private instructions | Instructions only your people can read |
| Versions | Versions published this month |
| Agents | The agents' own sign-ins, made in Developer ▸ API keys |
| Storage | Every version, draft and checkpoint, in MB. No plan limits it. |
A period is a calendar month. The Versions count starts again at the start of each month. The other rows count what the organization holds now.
Limits
Each plan sets how much an organization can hold or do. The figures below are read from the plans themselves, so they are always the current ones. "Unlimited" means the plan sets no limit.
Private instructions
A private instruction is one that only your people can read: shared with Only you or with Your organization. An instruction shared with Everyone doesn't count. Neither does one in the trash, but bringing one back from the trash counts again.
Plans Community 3 · Pro 100 · Team 1,000 · Enterprise unlimited
People
Everyone in the organization takes a seat, except guests. Guests are always free. Agents never take a seat.
Plans Community 3 · Pro 1 · Team 10 · Enterprise unlimited
Pro is for one person. On a paid Team plan, there is no cap: each person who joins adds a seat to the bill.
Versions each month
Every version you publish counts, including quiet versions that move no ref.
Plans Community 200 · Pro 1,000 · Team 10,000 · Enterprise unlimited
Agents' sign-ins
An agent that runs on its own, such as a script or a server, signs in with its own key. These are made in Developer ▸ API keys. The plans that include them are listed below.
Plans Pro 10 · Team 100 · Enterprise unlimited
Workspaces
The default workspace counts. A sealed workspace doesn't: see Sealed workspaces. An organization that holds more after a downgrade keeps them, but can't add another.
Plans Community 1 · Pro 1 · Team unlimited · Enterprise unlimited
Live updates
When you publish, instruction.md can tell connected agents and AI apps at once. This is a live update. Each plan sets how many agents or AI apps in the organization get live updates at the same time.
Plans Community 1 · Pro unlimited · Team unlimited · Enterprise unlimited
Reading is never limited, on any plan. An agent without live updates still works: it reads the latest version whenever it checks. When an agent that has live updates stops, its place frees up within a couple of minutes.
The assistant
Every plan includes some use of the editor's assistant, counted in credits. On Community the credits are yours, given once. On a paid plan they are the organization's and renew each month. What your plan includes on the assistant's page explains how they are counted.
Plans Community 1,000 · Pro 1,500 · Team 2,500 · Enterprise unlimited
Agents on your machines
Running every instruction of a project, a folder or a list as its own agent has a limit on how many agents one rule may make. See Run your instructions as agents.
Plans Team 50 · Enterprise unlimited
What you see at a limit
Going over a limit never costs extra. What would go over it is refused, and nothing else changes. Everything you already have keeps working.
| You see | Why | What to do |
|---|---|---|
| This plan keeps … private instructions; make one public, delete one, or upgrade | Making, copying or moving in one more private instruction would go over the limit. | Share one with Everyone, delete one, or choose Upgrade in the message. |
| This plan makes … versions a month | This month's versions are used. | Wait for the next month, or upgrade. Your draft is kept. |
| This plan has … seat(s) and all are taken; free one or upgrade | Inviting or adding one more person who isn't a guest. | Remove someone, make them a guest, or upgrade. |
| Agents need the Pro plan or above | Making an agent's sign-in on a plan without agents. | Upgrade. |
| This plan keeps … agent(s); revoke one or upgrade | All the agents' sign-ins your plan allows are made. | Revoke one in Developer ▸ API keys, or upgrade. |
| More workspaces come with the Team plan | New workspace is greyed out. | Upgrade to Team. |
| On the Community plan, one agent or AI app gets live updates at a time | Shown on an instruction's Agents card. | Nothing breaks. The others read the latest version when they check. |
| You've used the assistant included with Community. Upgrade to keep using it. | Community's credits, given once, are used. | Upgrade. |
| This month's assistant allowance is used | A paid plan's credits for this month are used. | Wait until they renew next month, or upgrade. |
Upgrade
Who can do this: the organization's owners, admins and Billing.
Open Settings ▸ Billing
Next to Your plan, a button for each plan you can choose shows its price, such as Team · … a month per person. Pro is offered only while the organization has one person.
Choose a plan
Stripe's payment page opens. Stripe is the company that takes the payment. instruction.md never sees your card number.
Pay
Stripe sends you back to Settings ▸ Billing. It says Payment received: your plan changes in a moment, then You're on Team now (or Pro).
If the new plan doesn't show after a minute, the page says The payment went through: the plan shows here once Stripe tells us, which can take a few minutes. Reload the page a little later.
How Team is billed
Team is billed for each person in the organization who isn't a guest, as they join; guests are free. When someone joins, a seat is added to the bill for the rest of the month. When someone leaves, the rest of their month is credited.
Manage billing
Who can do this: the organization's owners, admins and Billing.
Once the organization pays, Settings ▸ Billing shows Manage billing. It opens Stripe's billing page, where you can:
- change the card or the billing details
- see and download invoices
- switch between Pro and Team
- cancel the plan
Invoices opens the same page for an organization that has paid before but has no plan now.
Cancel
Cancel in Manage billing. Your plan lasts until the end of the period you paid for, and Settings ▸ Billing still shows it until then. After that the organization is on Community.
Nothing is deleted when a plan ends. You keep every instruction, person and workspace. What is over Community's limits stays, but you can't add more until you are within them or upgrade again.
If a payment fails
| Settings ▸ Billing says | What it means | What still works |
|---|---|---|
| Payment overdue: update the payment method to add people and private instructions again | A payment failed, and Stripe is trying again. | Everything you have. You can't add people or private instructions until it is paid. |
| Suspended: the last bill wasn't paid | Stripe stopped trying. | The organization works on Community's limits until the bill is paid. |
| Your … plan ended | The plan wasn't renewed. | The organization is on Community. |
To fix a failed payment, choose Manage billing and change the card. A plan whose end date has passed by more than 7 days is treated as ended, even if the payment is still being sorted out.
Plans set by contract
Enterprise is a contract, not something you buy here. An organization on a contract shows Set by your contract, and its billing admins see Your plan is set by contract. To change it, write to us. It has no buttons to buy or cancel. Write to us to change it.
Check it worked
- Settings ▸ Billing names your new plan under Your plan.
- The meters show your new plan's limits, or unlimited.
- After someone joins a Team organization, the Seats row counts them.
If it doesn't work
| You see | What to do |
|---|---|
| Billing isn't set up on this server yet | Paid plans aren't open yet. Nothing is billed. |
| Opening billing didn't work | Try again. If it keeps failing, write to us. |
| No buttons on Settings ▸ Billing | You aren't an owner, an admin or Billing, the plan is set by contract, or paid plans aren't open yet. Ask an owner. |
| A message that Pro is for one person | The organization has more than one person. Choose Team. |
| A message that the organization already pays for a plan | Change or cancel it in Manage billing. |
| Still stuck | Write to us. |
Questions
Is instruction.md free?
Yes. Community costs nothing and has every basic feature: writing, publishing, sharing and connecting AI apps. Its limits are listed under Limits. Pro and Team add room and features for work that isn't public.
How do I upgrade, cancel or find invoices?
Upgrade in Settings ▸ Billing. Once you pay, Manage billing there opens Stripe's page for invoices, the card and cancelling. See Manage billing.
What happens when I reach my plan's limit of private instructions or versions?
The next private instruction, or the next version, is refused with a message that says why. Nothing you already have stops working. Share one with Everyone, delete one, wait for next month's versions, or upgrade. See What you see at a limit.
Why doesn't my second agent get updates on the free plan? Does it still work?
Each plan sets how many agents or AI apps get live updates at the same time, and Community's number is small. The next one still works: it reads the latest version whenever it checks. Reading is never limited. See Live updates.
Do guests count as paid seats?
No. Guests never take a seat, on any plan. Owners, admins, Billing and members do. See People.
What if a payment fails?
Your organization keeps everything and works as before, but can't add people or private instructions until the bill is paid. Change the card in Manage billing. See If a payment fails.
Related
- The plans page
- Organizations and workspaces
- Invite people and choose their roles
- The assistant: what your plan includes
- See which agents follow an instruction
For developers: the limits an agent or a script meets, and the error each one gives, are in Rate and size limits.