Sources
What Nota knows, it learns from sources: programs and files you already have. You mix them freely. Each reports only its part, and none needs to know of another.
| Source | What for | How |
|---|---|---|
| List (CSV) | deadlines, invoices, recurring amounts — everything no system reports | a file or an address; the two templates from nota init |
| Plan | a way of working as a template that one start date makes concrete | templates/plans/app-development.csv |
| todo.txt / Taskwarrior | tasks with a due date | the file you already keep |
| Beancount | cost, revenue and open receivables from the ledger | "format": "beancount" |
| Checks from outside | reachability, ports, certificate expiry | checks in the probe |
| This machine | disk, memory, load, a sign of life | "host" in the probe; nota init writes it |
| Hetzner Cloud | servers, volumes, IPs with list prices | hetzner in the probe, with a read-only token |
| Agent with Vector | the same as “this machine” and more, for those who run Vector anyway; runs of jobs | the agent/ folder of the source: the package nota-agent, with nota-report for jobs |
| Grafana / Alertmanager | alerts that already exist | the template templates/vector/grafana-alerts.yaml |
| Your own programs | everything else, such as the steps of an AI process | one HTTP call to /v1/ingest |
| Configuration | things and prices you set by hand | conf.d/*.json on the server |
What a source does, and what it does not
Section titled “What a source does, and what it does not”A source reports. Nota evaluates. Things are ticked off where they live: the payment is booked in the ledger, the task gets its x in todo.txt, the row in the list gets a date.
The probe reads files and asks addresses. It starts no other programs. A Taskwarrior export, for example, is written by your own cron job.
Which one to start with
Section titled “Which one to start with”- Nothing technical to watch: the two lists from
nota init. - A server:
nota initalready watches the machine it runs on. Add checks from outside. - Jobs and processes of your own: send records yourself.