blaktron/budget-app-builder
interactivev0.1.0
Reads your bank statements and payslips, talks you through income and spending, then builds a single self-contained HTML budgeting app.
Declared capabilities
data: files
Capabilities are the author's declaration and the basis for policy and scanning. The registry cannot enforce them at run time. Your runtime should.
MCP servers & tools
agentry run serves exactly the tools this contract declares, through a per-run MCP gateway. An undeclared capability is a tool that does not exist at run time.
Tools the runner grants
| Manifest declaration | Tool(s) granted |
|---|---|
| (always) | write_report — reports → the run's output folder |
| (always) | list_inputs, read_input, search_inputs — operator-provided input files, read-only |
| (always) | scratch_list, scratch_read, scratch_write, scratch_search — the run's own scratch folder at /scratch, private to the run and deleted at its end; the runner's grant, not a line of the contract |
| (always) | export_pdf — a Markdown report as a PDF in reports/, laid out in your report design; the runner's grant, not a line of the contract |
| (always) | grep, glob — search file contents by regular expression and list files by path pattern (ripgrep), one area a call: the inputs, attached knowledge, /scratch; the runner's grant, not a line of the contract |
MCP servers involved
- QuickAgent Tools — the runner's companion server, served through a per-run Docker MCP Gateway; its tool surface is exactly the table above.
- Operator-cataloged MCP servers may be attached for the declared dataAccess category (files); undeclared categories are never wired in.
In an embedded install
Installed into an existing coding agent (agentry install), the same contract maps to the host's built-in tools — enforcement there is the host's. Allowed tools: none declared (host defaults apply).
Install
agentry install blaktron/budget-app-builder@0.1.0git clone https://secureagentry.net/blaktron/budget-app-builder.gitgit clone ssh://git@git.secureagentry.net/blaktron/budget-app-builder.gitclaude-skill is this agent's default target, so the flag is not needed.
agent.yaml
2.2 kBBack to files
schemaVersion: "2"
name: budget-app-builder
namespace: blaktron
version: 0.1.0
summary: "Reads your bank statements and payslips, talks you through income and spending, then builds a single self-contained HTML budgeting app."
license: "MIT"
tags: ["budgeting", "personal-finance", "html", "expenses", "income", "savings"]
modes: [interactive]
entrypoints:
instruction: AGENT.md
intake:
- id: documents
prompt: "Add your financial documents: bank or card statements, payslips, a CSV export, a loan schedule. None is fine; we'll work from what you tell me."
type: file
- id: currency
prompt: "Which currency should all amounts be in? Leave it blank and I'll detect it from the documents and tell you what I picked."
interactive:
opening: "Add your statements or payslips and tell me what this budget needs to fix. I'll read them, then ask a few questions before building the app."
guide:
overview: "It reads the financial documents you add, works out your real monthly income and spending, and asks you about the gaps cash flow cannot show. Then it writes one HTML file: a budgeting app that opens in any browser and already holds your agreed envelopes, transactions and savings goal. Everything stays on your machine, and the app asks for nothing from the network."
prepare: ["Bank or credit-card statements for the last 3 months, as PDF or CSV.", "A recent payslip or two, so take-home is read rather than remembered.", "A list of costs that never touch a bank account: cash rent, child care, money sent home.", "Any one-off payment in the next 90 days you want the budget to cover.", "One sentence on what this budget should fix: a debt, a goal, or overspending."]
files: "Add statements, payslips, or a bank CSV export under /inputs. PDFs with selectable text and CSV exports read best; a scanned page may return no text, so paste the figures or export a CSV instead."
task: "e.g. Read these three months, then build me a budget that clears the card by December."
capabilities:
network:
egress: none
filesystem:
read: none
write: none
exec: none
dataAccess: [files]
publish:
include: [agent.yaml, AGENT.md, README.md, LICENSE]