Command-line tool and TypeScript library

nina

Query Germany’s federal civil-protection warning system from your terminal. nina is a command-line tool over the open NINA API (warnung.bund.de): fetch current warnings by source, look up the full detail or geometry of any alert, check a region by its official key, and browse the MoWaS archive — as clean JSON you can pipe straight into jq.

Version 0.0.6 npm GitHub API reference

Install

Needs Node.js 20 or newer. Installs the nina command:

npm i -g @maschinenlesbar.org/nina-warnungen-cli

Access

No account, no API key, no configuration — install and query.

Quick start

nina map-data dwd

Commands

All commands, arguments and options →

Claude Code skills

The nina plugin teaches Claude to use nina. Install it from the maschinenlesbar.org marketplace:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install nina@maschinenlesbar

TypeScript library

@maschinenlesbar.org/nina-warnungen-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.