kmi-irm-cli

README

☀️ kmi - the IRM KMI Weather from your terminal

Belgian weather CLI using KMI/IRM data. Get forecasts, radar, warnings, and UV index from your terminal.

$ kmi forecast Brussels
Weather for Brussels
Day  Cond  Temp      Rain
Now  ☁️    8°C Cloudy
Thu  🌧️    4-5°C     100% / 3mm
Fri  🌧️    0-5°C      50% / 1mm
Sat  🌧️    4-12°C    100% / 1mm

Agent Skill

This CLI is available as an open agent skill for AI assistants including Claude Code, OpenClaw, Codex, Cursor, GitHub Copilot, and 35+ agents.

npx skills add dedene/kmi-irm-cli

Installation

Homebrew (macOS/Linux)

brew install dedene/tap/kmi

Go

go install github.com/dedene/kmi-irm-cli/cmd/kmi@latest

Download Binary

Download from GitHub Releases.

Available for:

• macOS: Intel & Apple Silicon (tar.gz)
• Linux: amd64 & arm64 (tar.gz)
• Windows: amd64 & arm64 (zip)

Usage

Current Weather

kmi current Brussels
kmi current 50.85,4.35    # coordinates
kmi current @home         # saved favorite

Forecast

kmi forecast Leuven       # 7-day forecast
kmi daily Leuven          # daily breakdown
kmi hourly Leuven         # hourly for next 12h

Radar

kmi radar Brussels        # download radar animation frames

Warnings

kmi warnings Belgium      # weather warnings

UV Index

kmi uv Antwerp

Favorites

Save locations for quick access:

kmi favorites add home 50.85,4.35
kmi favorites add work Brussels
kmi favorites list

# Then use with @
kmi forecast @home
kmi current @work

Output Formats

kmi forecast Brussels           # table (default)
kmi forecast Brussels --json    # JSON
kmi forecast Brussels --plain   # TSV for scripting

Configuration

Environment Variable	Description	Default
KMI_LANG	Language (en, nl, fr, de)	en
NO_COLOR	Disable colored output	-

Shell Completions

# Bash
kmi completion bash > /etc/bash_completion.d/kmi

# Zsh
kmi completion zsh > "${fpath[1]}/_kmi"

# Fish
kmi completion fish > ~/.config/fish/completions/kmi.fish

About

This CLI uses the same API as the official KMI/IRM website. No API key required. Rate limiting is built-in to be respectful to the service.

KMI = Koninklijk Meteorologisch Instituut (Dutch) IRM = Institut Royal Météorologique (French)

License

MIT