Learn · Practical guide
How to run your books with the AI agent you already use
Start with one customer, one invoice, one payment, and one expense. Your agent handles the routine work; a real ledger keeps every result balanced, reviewable, and ready for the questions founders actually ask.
I was a founder who wanted an answer, not a second job. But in the early days, I was the finance department by default. Nobody decided it. It landed on me because there was no one else.
If you have just incorporated, you may be in the same spot: no bookkeeper, no books, and no desire to spend Sunday night inside accounting software. You do have Hermes, Claude Code, or Codex open already.
This guide shows how to start clean with that agent. It does not cover migration from an existing QuickBooks or Xero ledger.
Which agent do you use?
The setup, examples, and prompts below will adapt to your choice.
Claude Code × Economico
Called 2 Economico tools
That answer is useful because it refuses to manufacture certainty. Here is how to build the books beneath it.
What “agent-native general ledger” actually means
An agent-native general ledger is double-entry books your AI agent can read and write directly, via tools instead of a dashboard.
The agent supplies intent and the business context it already has. Typed tools perform allowed bookkeeping operations. The ledger posts the balanced entry and preserves the audit trail.
That is different from exporting a CSV, pasting it into a chatbot, and asking for a summary. A spreadsheet can show what happened to your bank account. Accrual books also show what the business earned and owes — different numbers that matter when an invoice has gone out but the cash has not arrived.
| Dashboard-first books | Agent-native books | |
|---|---|---|
| How work starts | Log in, find the screen, enter the transaction | Tell the agent what happened in plain English |
| How AI sees the books | Export, paste, or use a separate copilot | Read and write the ledger through typed tools |
| Accounting structure | Real books, operated through a human UI | Real books, operated through bounded agent actions |
| Founder outcome | Learn the accounting workflow | Ask for the outcome and review what was recorded |
The point is not “better chat.” It is real books without having to live in an accounting dashboard every month.
Before you start
This walkthrough is deliberately small. It is for a new SaaS or consulting business starting its books clean.
You need an Economico account and one supported agent. You do not need an existing chart of accounts, prior accounting knowledge, or a bookkeeper before you begin routine books. New accounts are created during the browser sign-in flow.
You still need a qualified professional for tax filings, jurisdiction-specific rules, and material edge cases. Clean routine books make that review easier; software does not turn tax judgment into a button.
Connect the agent you already use
Show setup for
Connect Hermes with the Skills Hub
hermes skills tap add economico/cfo-skills
/setup-economico
Hermes × Economico
Called 2 Economico tools
Connect Claude Code over MCP
claude mcp add economico https://economi.co/mcp
Which Economico business am I connected to? Show my chart of accounts.
Claude Code × Economico
Called 2 Economico tools
Connect Codex with the skill pack
npx skills add economico/cfo-skills
Run the setup-economico skill to connect and authenticate my books.
Codex × Economico
Called 2 Economico tools
All three paths arrive at the same place: one business, one ledger, and the same bounded bookkeeping tools.
The trust contract: controlled delegation, not autonomous magic
- Your email
- Your CRM
- Your bank
- Your files
Your email, CRM, bank, and files stay yours — your agent already reads them, and nothing new gets wired in.
The agent does not get a blank journal-entry canvas for routine work. An invoice tool posts the invoice shape. A payment tool clears the receivable. A personally paid receipt records an expense and what the company owes the founder. Those operations must balance before they post.
That solves structural accuracy. It does not make business judgment infallible.
- Context can still be wrong. The agent may misunderstand what a payment was for or choose the wrong expense context. Tell it to ask when a fact is missing.
- Retries are safe. Stable references keep supported write paths from creating a second journal when the agent retries.
- Corrections remain visible. Voids and reversals preserve what happened instead of deleting history.
- Ambiguity gets reviewed. Confirm uncertain classifications, and use a qualified professional for tax and jurisdiction-specific treatment.
After a write, ask the agent to show the resulting invoice, receipt, income statement, or balance sheet. Delegation works better when the proof is one prompt away.
Your first week: 6 prompts, one set of books
The company below is simulated, but the numbers are not improvised. Every snapshot comes from TinyCRM Studio’s generated scenario ledger and ties assets to liabilities plus equity.
TinyCRM Studio · the first week in six prompts
Watch the books become useful.
Every prompt changes the same reconciled ledger. Copy one into your agent, or scroll the whole first-week story from customer setup to an honest runway answer.
Start with the money that is actually there
Nora and Basil contribute $20,000 and close a $100,000 SAFE. The agent records both sources without pretending either is revenue.
3 tool calls
Economicocreate_share_class✓
Economicoissue_shares✓
Economicorecord_safe✓
Give the first customer a home in the books
Juniper Bio signs up for TinyCRM's $499 Growth plan. Customer, contract, and recurring obligation are linked before money moves.
2 tool calls
Economicocreate_party✓
Economicocreate_contract_from_plan✓
Send the first invoice
The invoice posts revenue and the amount Juniper owes. Cash does not move just because an email was sent.
2 tool calls
Economicocreate_invoice✓
Economicosend_invoice✓
Record what landed in the bank
Four days later the payment arrives. The agent clears receivables into the named operating account instead of counting the sale twice.
2 tool calls
Economicoget_invoices✓
Economicorecord_payment✓
Handle the awkward founder-paid receipt
Nora paid a $40 Vercel receipt personally. The expense belongs to TinyCRM, but company cash never moved, so the books show what the company owes her.
3 tool calls
Economicocreate_party✓
Economicocreate_party✓
Economicorecord_receipt✓
Ask for the truth, even when it is early
The first useful report is not a made-up forecast. It is a tied balance sheet, a first P&L, and a clear statement that one week cannot establish a reliable burn trend.
2 tool calls
Economicoget_income_statement✓
Economicoget_balance_sheet✓
The critical moment is the payment. Sending an invoice records revenue and accounts receivable. Recording the payment later moves that receivable into cash; it does not count the revenue twice.
Claude Code × Economico
Called 2 Economico tools
A customer's payment just landed in our operating account. Find the matching open invoice, record the payment once, and show me how cash and accounts receivable changed.
The awkward receipt matters too. If Nora pays Vercel personally, company cash did not fall. record_receipt records the $40 hosting expense and credits 2135 Due to Related Parties, so the balance sheet shows that TinyCRM owes Nora $40.
That is what real books add: not more ceremony, but fewer invented facts.
Quick reference: founder tasks and the tools beneath them
| What you ask | Tools the agent uses | What to review |
|---|---|---|
| Add a customer and terms | create_party, create_contract_from_plan | Name, pricing, start date, payment terms |
| Bill a customer | create_invoice, send_invoice | Customer, amount, service period, due date |
| Record incoming cash | get_invoices, record_payment | Matching invoice, amount, destination account |
| Pay a vendor bill | receive_bill, approve_bill, pay_bill | Document, expense context, approval, cash account |
| Record an expense paid personally | create_party, record_receipt with paid_by_party_id | Vendor, founder, amount, expense context |
| See burn, runway, and default-alive status | get_saas_metrics, get_balance_sheet, check_default_alive | Whether enough operating history exists for a trend |
| Find the next finance task | get_inbox | Missing context and the suggested next action |
| Correct a mistake | void_invoice, void_bill, or reverse_unapplied_cash | Reason and compensating entry; the original remains visible |
Why this is not ChatGPT on top of a spreadsheet
A spreadsheet is a reasonable lightweight record of cash. Dashboard-first accounting software gives you real books, provided someone operates its workflow. ChatGPT on top can summarize either one, but the copy-paste round trip remains and the chatbot does not become the accounting system.
An agent-native ledger changes the operating model. Your agent posts directly through bounded tools. The invoice, payment, receipt, and reports all come from the same double-entry source.
That does not mean a new founder needs every finance feature on day one. The minimum useful loop is deliberately boring: one customer, one invoice, one payment, one expense, and one question you need answered. The books underneath stay real as the business grows.
What the agent still needs from you
Your agent needs the facts only the operator knows: what a transaction was for, which customer or vendor it belongs to, and whether the source document is complete.
When context is clear, routine bookkeeping should not require significant monthly supervision. When it is not clear, the right behavior is a question — not a confident guess.
You also still need a qualified professional for tax filings, jurisdiction-specific advice, and material edge cases. The agent removes repetitive work. It does not hide founder responsibility.
Common questions
Frequently asked questions
Can the agent make an accounting mistake?
Yes, it can misunderstand business context. Economico reduces a different class of error: routine operations use typed tools whose journal shape must balance. Review ambiguous classifications and ask to see the resulting document or report after a write.
Do I still need a bookkeeper or CPA?
You do not need a bookkeeper before beginning this narrow routine loop for a new business. You do need qualified help for tax filings, jurisdiction-specific rules, and material or unusual accounting questions. Clean books make that help faster and more useful.
Is this GAAP-compliant?
Economico keeps accrual, double-entry books: invoices can create receivables before cash arrives, bills can create payables before cash leaves, and every posted journal must balance. That is GAAP-shaped accounting infrastructure, not a professional assurance opinion about every business fact or tax treatment.
Is my data safe, and who can see it?
Browser OAuth grants the agent owner-scoped access to one Economico business. You do not paste a bank or accounting password into chat. Economico’s token covers its finance tools; it does not inherit standing access to your email, bank, CRM, or files.
What if I already use QuickBooks or Xero?
This guide is for a new business starting clean. Migrating an existing ledger is a separate workflow and is not promised here. Keep the existing system authoritative until a migration has been planned and reconciled.
What happens when the agent retries?
Supported write paths use stable references so a retry returns the existing result rather than posting a second journal. Ask the agent to verify the resulting document or balance instead of repeating an uncertain command with changed facts.
Can I undo a mistake?
You correct posted activity with a void, reversal, or compensating entry. The original remains in the audit trail. Draft documents can be changed before they post.
How much work is left for me?
Provide missing business context, review ambiguity, and check the finance inbox for what needs attention. The aim is controlled delegation with ease and clarity — not set-and-forget autonomy.
Run the first-week loop in your agent
Start with one customer, one invoice, one payment, one expense, and one honest burn/runway question. That is enough to make the books useful without building a finance department.
Try it with Hermes
Hermes · Skills Hub + CLI
Put your first week in the books with Hermes
Browser sign-in grants access to one Economico business. Then Hermes walks the loop with you.
Try it with Claude Code
Claude Code · MCP + OAuth
Put your first week in the books with Claude Code
Connect over MCP with browser OAuth. No accounting password gets pasted into chat.
Try it with Codex
Codex · Skills + CLI
Put your first week in the books with Codex
The setup skill handles the connection and browser authentication. Then Codex walks the loop with you.
Then ask:
Help me start clean books for this new company. Begin with our opening cash, then walk me through one customer, one invoice, one payment, and one expense. Ask whenever a business fact is missing, show me what each step changed, and finish with an honest first-week P&L and balance sheet.
From there, learn what burn rate actually tells you or browse the pricing and invoicing playbooks.