A tour of Codex
Codex is the money side of your portal. Open it at /admin/codex (Codex in the admin nav) and you'll find six sections along the top: Overview, Jobs, Bank, Spending, Board, and Reports. This page walks through what each one is for.
A shared date-range bar sits on the Overview, on Spending, and on both reports. Pick a preset like this month or year to date, or set your own dates, and every number on the page follows.
Overview
The Overview at /admin/codex is built to be opened every morning. Five cards up top:
- Net: money collected minus business spending from your bank, for the range you picked, with your margin percent and how it compares to the prior period.
- Collected: payments in, with the trend against the prior period.
- Spent: business spending out of your bank for the range, with its own trend.
- Outstanding: what's still owed to you right now, across every job, with a callout for how much of that is overdue.
- To review: how many bank items are waiting to be sorted, with a "sort them now" link straight to the review queue.
Under the cards, a jobs strip gives you the day's job picture at a glance: how many jobs are open, which are done but not fully billed, and the job with the thinnest margin.
Below that:
- The tax set-aside card keeps a running estimate of what to put away for taxes this year, based on your real net and the rate you set in Settings, then Codex.
- The morning briefing (when turned on in Settings, then Codex) writes a short plain-English readout of the day's findings.
- Insight cards flag what deserves a look: money past due, jobs over budget or losing money, thin margins, charges that look like doubles, recurring charges, deposits to check, and your most profitable client. Each card links to the place where you can act on it.
If you have an old bookmark to /admin/codex/insights, it still works. Insights merged into the Overview, so that address lands here now.
Jobs
/admin/codex/jobs lists every job's money on one line: contract value, invoiced, collected, outstanding, cost, margin in dollars and percent, and billable hours. Filter to open or completed jobs, narrow to one client, or search by name. Click a job to open its full money detail.
The three cards above the table total up the jobs you're looking at: open count, collected, and outstanding.
Bank
The Bank section is the feed itself: every transaction from your connected accounts, the To review queue, connected banks, rules, and categories. It also holds Sort everything, the wizard at /admin/codex/sort that sorts a whole backlog in one supervised run.
Bank has its own guides: Connecting your bank and reviewing transactions and Sort everything with the Sort Wizard.
One address note: the old Activity page moved into Bank. A bookmark to /admin/codex/activity now opens the Bank transaction list.
Spending
/admin/codex/spending shows your business costs outside of jobs, three ways:
- Recurring: vendors that bill you on a rhythm, detected from about the last seven months of your feed, with their cadence and what they add up to per month. Vendors you haven't sorted yet are marked "needs sorting". Pick a category right in the row and click Make a rule so every future charge from that vendor sorts itself.
- By category: where this range's overhead went, as a bar per category. Every category maps to its IRS Schedule C line on the P&L. Click a bar to see the charges behind it. The bars count only deductible spending; owner pay and draw and other non-deductible categories sit on their own labeled line below the bars, excluded from the total, so this section always matches the P&L.
- Top vendors: who took the most in the range.
Board
/admin/codex/board is the drag-and-drop workspace for job costs. Unassigned bank charges sit on one side, your jobs grouped by client on the other. Drag a charge onto a job and it counts as that job's cost, with the margin updating as you drop. Charges can also be marked overhead or personal right from their card, and an Auto-sort with AI button suggests homes for whatever is currently in view.
Reports
Two reports share the Reports section:
- Profit and loss at /admin/codex/pnl: income by client and expenses by category for any range, each expense category with its IRS Schedule C line, down to the net profit number. The Download tax summary button exports the whole thing as a spreadsheet for your accountant.
- Cash flow at /admin/codex/cashflow: money in and out of your business, month by month, so you can see the shape of your year and not just the totals.
Both are covered in depth in Job profit, P&L, and cash flow.
Every report reads from your sorted bank activity and your real invoices. A brand-new Codex with an unsorted feed shows thin numbers. Sort the backlog once with the Sort Wizard and the reports fill in.
