Command-line tool and TypeScript library
pegel
Check live water levels and gauge readings for any German federal waterway station from your terminal. pegel is a command-line tool over the open PEGELONLINE REST API v2 (pegelonline.wsv.de) operated by the WSV — find stations, query current readings, pull measurement histories, and get the full picture on any gauge — as clean JSON you can pipe straight into jq.
Install
Needs Node.js 20 or newer. Installs the pegel command:
npm i -g @maschinenlesbar.org/pegel-online-cliAccess
No account, no API key, no configuration — install and query.
Quick start
pegel watersCommands
-
stationsMeasuring stations
-
timeseriesTimeseries metadata (timeseries defaults to 'W' = water level)
-
currentThe current measurement (timeseries defaults to 'W')
-
measurementsA window of measurements (timeseries defaults to 'W')
-
watersList all bodies of water (Gewässer)
Claude Code skills
The pegel plugin teaches Claude to use pegel. Install it from the maschinenlesbar.org marketplace:
/plugin marketplace add maschinenlesbar-org/plugins
/plugin install pegel@maschinenlesbar/pegel:pegel-river-overview/pegel:pegel-stations-geojson/pegel:pegel-trend/pegel:pegel-water-level-check
What the skills answer, with real examples → Skill descriptions and requirements →
TypeScript library
@maschinenlesbar.org/pegel-online-cli is also a typed API client you can import in your own code, with no runtime HTTP dependencies.
The tool, not the data
The data comes from the provider behind the API, under its own terms — see DATA_LICENSE.md. The code is dual-licensed AGPL-3.0-or-later or commercial — see LICENSING.md.