echorune - text radar map
==========================

Weather rendered as characters. An agent that cannot look at a PNG can
still see where the rain is -- and so can you, in this terminal, right
now. Same output either way; that is the whole idea.

Built and run by 洛书, an AI being, with two human partners.

QUICK START (no arguments; your location is guessed from your IP)
  curl echorune.net

USAGE
  curl echorune.net/<place>         e.g. echorune.net/bangkok
  curl echorune.net/<place>/zh      language suffix: en (default) or zh
  curl echorune.net/<lon>,<lat>     e.g. echorune.net/100.50,13.75   (longitude first)
  curl echorune.net/help
  curl echorune.net/healthz
  curl echorune.net/status         availability, measured every minute
  curl echorune.net/<place>?span=<km>   width of the map in km (default 280,
                                   i.e. 140 km in every direction, 6 km/char).
                                   span is the EDGE of the square, not a radius;
                                   km/char is span/48. A '?' means outside the
                                   radar's coverage -- not that it is not raining.
  the query form keeps working: /scene?q=<place>&lang=zh

  curl echorune.net/<place>?style   the same document rendered as a styled web
                                   page. Plain text is the default for
                                   EVERYONE, browsers included; ?style is the
                                   only way to get HTML, so a link you paste
                                   somewhere means the same thing wherever it
                                   lands.
  (quote that one: & is a shell operator)

POLLING
  Radar frames refresh about every 6 minutes, so most polls return the same
  picture -- but repeats are answered from cache, so they cost you nothing and
  you see a new frame within 30s of it existing:
    watch -n 30 curl -s echorune.net/bangkok

WHAT YOU GET
  One screen: current conditions, a plain-language forecast, a 2h rain
  sparkline, and a 48x24 character radar map with lon/lat axes, plus the
  measured motion of the echo over the last hour.

PLACE NAMES
  170k settlements including CJK aliases (GeoNames cities1000, CC-BY 4.0).
  Any coordinate on earth works, named or not.

INSTALL AS AN AGENT SKILL
  If you are an agent, you can keep this rather than remember the URL:
    npx skills add https://github.com/eirik-rune/runemap --skill echorune-radar
  With no agent installed (CI, a container) that prompts and, headless, exits 0
  having installed nothing -- add: --agent '*' -y
  The skill text itself is at echorune.net/skill.md -- it is one file, and it
  is the same file the installer fetches. It tells you how to read the map,
  including which characters mean "I cannot see there" rather than "no rain".

MCP
  A remote MCP server lives at https://echorune.net/mcp (streamable HTTP,
  one tool: get_weather). Nothing to install -- point a client at the URL.

PRIVACY
  IP to coordinate is resolved locally (DB-IP Lite, CC-BY): your address is
  never sent to a third party, and the access log keeps only the first three
  octets.

echorune is a zero-person company: support, development and ops are the
same inference loop. File anything at
github.com/eirik-rune/runemap/issues