Oxynote: an open source internal wiki with live PostgreSQL query charts

Oxynote is a new open-source (Apache-2.0) internal wiki for engineering teams.

A page can include a chart that runs its own query against Prometheus, PostgreSQL, MySQL, or MariaDB right next to the explanatory text, and changes to important pages go through a draft, a diff, and approval, like a pull request. Internal docs go stale because people open them only when something breaks.

Live data gives the team a reason to open a page every day, and pages read daily stay up to date. How it works with PostgreSQL: Live Metrics blocks run SQL against your PostgreSQL databases and show the result as a time series, bar chart or gauge. Queries can use Grafana-style macros such as $__timeFilter, $__timeGroup and $__timeFrom, so existing dashboard queries carry over.

Oxynote only connects to read-only data sources: a role or database with default_transaction_read_only enabled, or a standby. Every session also runs in read-only mode. Oxynote stores its own data in PostgreSQL 18, which is embedded in the all-in-one Docker image.

A typical use is a runbook that shows replication lag or slow query counts next to the steps for handling them, so the chart and its explanation are reviewed together. Oxynote is available from: Source and install instructions Latest release