Docs The app
Money
Money shows what a project spends and makes, whether each plan pays, and how many subscribers it needs to break even. Every figure says whether it is Actual or Projected. Nothing in this tab can spend money or change a budget anywhere.
Actual and Projected
- A figure is Actual only when it comes from a connector's reading, an entered receipt, or the token counts a provider reported for the assistant's own calls.
- Anything worked out from an assumption is Projected, and the label sits beside the number. A cost line typed by hand is Projected; only a receipt is Actual.
- "Today" is the server's date. A reading that is old says how old it is.
- In the demo workspace every figure also carries "Demo data".
The top of the tab says when each connector last ran and which numbers are Projected.
The four views
| View | Shows |
|---|---|
| Statement | The last full month (Actual), the month so far (Actual) and the month to its end (Projected): revenue on top, costs grouped by where they come from, the result at the bottom. Each line names its source, when it ran and the rate it was converted with, and opens to its parts and days. Above it, four figures for the last full month: costs, revenue, result, and subscribers against break-even. |
| Per plan | What one subscriber of each plan pays and leaves after store fee, tax and variable cost, and subscribers by plan and store |
| Break-even | The calculator: subscribers needed to cover a month's costs, with what-if inputs, a chart of revenue against cost, and saved scenarios |
| Cost lines | Costs entered by hand and receipts, the project's and the workspace's, and the CSV upload |
Where the numbers come from
| Source | What it brings |
|---|---|
| Connectors | Costs from AWS, Google Cloud and Azure; usage and cost from model providers; revenue and subscribers from RevenueCat, Stripe and the stores' own sales figures; usage or cost from Vercel, Cloudflare and Supabase |
| Agents | Measured costs, revenue, usage and subscribers, reported with signals:write. Money names the agent as the source. |
| A CSV upload | Dated amounts, uploaded by an Owner or Admin |
| An Owner or Admin | Price plans, cost lines, receipts (a cost paid once, with its vendor and the receipt file), scenarios and currency rates |
No agent can write a plan, a cost line, a receipt, a scenario or a rate, and an agent reads Money only through its statement.
Currencies
Each amount keeps its own currency. Totals use the workspace's base currency (EUR unless whoever made the workspace named another; an Owner or Admin can change it) and rates that an Owner or Admin enters by hand. Turnkeel calls no rate service. Each total says which rate and date it used. An amount with no rate is listed apart, left out of the total, and the page says so.
Break-even
Break-even counts every cost of a month. When you leave them empty, the calculator works out its fixed costs (every cost but ads) and its ad budget (last month's ads):
- Recurring costs at a month's amount: a cost line paid monthly, or a twelfth of a yearly one; a connector's line at last month's measured amount.
- Costs paid once, a receipt included, spread as a twelfth a month for twelve months from the day paid, so a yearly bill is never missed.
- The workspace's own costs, split equally across its active projects.
The calculator lists the parts of each default with their amounts, and a number you type replaces the default. While a cost it needs has no rate into the workspace's currency, break-even shows no number and names the rate it needs, as in "Enter a rate for USD to see break-even."
Agents and Money
| Tool | Command | Scope | Does |
|---|---|---|---|
report_signals |
turnkeel signal add, turnkeel signal post |
signals:write |
Reports measured costs, revenue, usage or subscribers |
read_money |
turnkeel money |
money:read |
Returns the statement, with each figure's basis, source and rate, and break-even |
A reading with the same id replaces the agent's own earlier reading and no one else's. --ads puts a cost in the Ads group.
Assistant usage and hours
Where the workspace has used the assistant, Money lists its calls per model and month, with the tokens in and out (Actual). A cost shows only where an Owner or Admin entered a rate for that model, and is Projected. These lines are in no total, because a usage connector for the same account already brings in what the provider charged.
While time tracking is on, Money shows the hours people entered, per person and per area, by month. The section says "Hours as people entered them." Hours are never turned into money and are in no total. Each person sees their own hours; an Owner or Admin sees everyone's.
The source of this page will be on GitHub when the repository opens. Something wrong or unclear? Write to us.