kmi-cli

name: kmi-cli description: > Query Belgian weather via KMI/IRM meteo.be API. Use when user wants forecasts, current weather, radar, warnings, or UV index for Belgian locations. Triggered by mentions of Belgian weather, KMI, IRM, meteo.be, or Belgian forecast. license: MIT homepage: https://github.com/dedene/kmi-irm-cli metadata: author: dedene version: "1.0.0" openclaw: requires: bins: - kmi install: - kind: brew tap: dedene/tap formula: kmi bins: [kmi] - kind: go package: github.com/dedene/kmi-irm-cli/cmd/kmi bins: [kmi] - kind: binary url: https://github.com/dedene/kmi-irm-cli/releases/latest bins: [kmi]

CLI for KMI/IRM - Belgian weather data from the Royal Meteorological Institute.

Quick Start

# Current weather
kmi current Brussels

# 7-day forecast
kmi forecast Leuven

# Weather warnings
kmi warnings Belgium

# UV index
kmi uv Antwerp

No Authentication Required

This CLI uses the public meteo.be API. No API key or registration needed.

Core Rules

Always use --json when parsing output programmatically
Location formats: city name (Brussels), coordinates (50.85,4.35), or favorite (@home)
Use favorites with @prefix - e.g., kmi forecast @home
Rate limiting is automatic - CLI handles this transparently

Output Formats

Flag	Format	Use case
(default)	Table	User-facing display
`--json`	JSON	Agent parsing, scripting
`--plain`	TSV	Pipe to awk/cut

Workflows

Current Weather

# By city name
kmi current Brussels

# By coordinates
kmi current 50.85,4.35

# By saved favorite
kmi current @home

# JSON output for parsing
kmi current Brussels --json

Forecast

# 7-day forecast
kmi forecast Leuven

# Daily breakdown
kmi daily Leuven

# Hourly for next 12 hours
kmi hourly Leuven

# JSON output
kmi forecast Leuven --json

Radar

# Download radar animation frames
kmi radar Brussels

# Specify output directory
kmi radar Brussels --output-dir ~/tmp

Note: Radar downloads image files to the current or specified directory.

Warnings

# Get active weather warnings
kmi warnings Belgium

# JSON for scripting
kmi warnings Belgium --json

UV Index

# UV index for location
kmi uv Antwerp

# JSON output
kmi uv Antwerp --json

Favorites

# Save a favorite location
kmi favorites add home 50.85,4.35
kmi favorites add work Brussels

# List all favorites
kmi favorites list

# Use favorites with @ prefix
kmi forecast @home
kmi current @work

# Remove a favorite
kmi favorites remove work

Scripting Examples

# Get current temperature
kmi current Brussels --json | jq -r '.temperature'

# Check if rain is expected today
kmi forecast Brussels --json | jq -r '.[0].precipitation'

# Get warning count
kmi warnings Belgium --json | jq 'length'

# List all forecasted conditions
kmi forecast Brussels --json | jq -r '.[] | "\(.day): \(.condition)"'

Environment Variables

Variable	Description
`KMI_LANG`	Language (en, nl, fr, de)
`NO_COLOR`	Disable colored output

Guidelines

No API key needed - works out of the box
Favorites require user setup - do not create favorites without user consent
Rate limiting is handled automatically - no special handling needed
Radar command downloads files - inform user about file output

Installation

# macOS/Linux
brew install dedene/tap/kmi

# Windows - download from GitHub Releases
# https://github.com/dedene/kmi-irm-cli/releases