コマンド一覧

すべてのコマンドは共通で次のオプションを受け付けます。

オプション	内容
-V, --version	バージョンを表示
-h, --help	ヘルプを表示
--no-config	設定ファイルを読まずに実行

--json は today tomorrow weekly fortnight 3h 6h 12h 24h locate にあります。cache は --clear だけです。

-V は Nix ビルドで焼き込まれた OTENKI_VERSION を最優先し、無ければ package.json の version を読みます。

today tomorrow weekly fortnight 3h 6h 12h 24h の地点は、設定ファイル に location を置けば省略できます。command を置けば、コマンド名なしの otenki がそのコマンドとして動きます。設定ファイルは $XDG_CONFIG_HOME/otenki/config.json です。

today

現在の天気。

bunx otenki-cli today <location...>

3 行で出します。1 行目が場所、2 行目が天気と気温（この数字が主役）、3 行目が残りの事実です。表の 1 行に詰めると、どれが主かもう読み手に任されてしまいます。

$ bunx otenki-cli today 函館
函館市 北海道
☀️ 快晴  13.8℃  体感 12.1℃
風 9.1 km/h · 湿度 72% · 降水 0.0 mm · 2026-10-04 22:45
Get Locate: https://www.geonames.org/
Get Weather: https://open-meteo.com/

最後の 2 行は stderr へ出ます。地名データの提供元（GeoNames）と予報の提供元（Open-Meteo）へのクレジットで、どのコマンドでも出力のあとに同じ 2 行が付きます。stderr なので、--json やパイプの出力は汚しません。

オプション	内容
--json	生 JSON を出力

tomorrow

明日の予報。内部的には 2 日分を要求し、2 日目を使います。

bunx otenki-cli tomorrow <location...>

$ bunx otenki-cli tomorrow 横浜
横浜市 神奈川県
🌤️ 晴れ  16.1℃ ~ 23.1℃
10-08 (木) · 降水 0.0 mm（確率 0%） · 風 9.6 km/h

オプション	内容
--json	生 JSON を出力

weekly

7 日間の予報。

bunx otenki-cli weekly <location...>

罫線はヘッダーの真下に入る 1 行だけです。見出しは日本語で、列は日付・天気が左、数字が右に寄るので、桁がそろって読み比較できます。気温は最低と最高の 2 列に分かれ、天気の記号は天気列の中に収まっています。

$ bunx otenki-cli weekly 横浜
横浜市 神奈川県 — 7日間予報
日付        天気                 最低    最高    降水  確率       風速
──────────────────────────────────────────────────────────────────────
10-07 (水)  ☁️ 曇り            17.9℃  23.5℃  0.0 mm   69%  13.6 km/h
10-08 (木)  🌤️ 晴れ            16.1℃  23.1℃  0.0 mm    0%   9.6 km/h

表の幅は列の内容から決まります。端末幅で切り詰めたり列を落としたりはしません。狭い端末では右にはみ出します。

オプション	内容
--json	生 JSON を出力

fortnight

2 週間（14 日）の予報。

bunx otenki-cli fortnight <location...>

$ bunx otenki-cli fortnight 横浜
横浜市 神奈川県 — 14日間予報
日付        天気                 最低    最高    降水  確率       風速
──────────────────────────────────────────────────────────────────────
10-07 (水)  ☁️ 曇り            17.9℃  23.5℃  0.0 mm   69%  13.6 km/h
10-08 (木)  🌤️ 晴れ            16.1℃  23.1℃  0.0 mm    0%   9.6 km/h

14 日は 2 週間分です。Forecast API の上限は 16 日で、forecast_days を 17 以上にすると拒否されます。

過去の天気が必要な場合は Historical Weather API を直接使ってください。

オプション	内容
--json	生 JSON を出力

3h / 6h / 12h / 24h

直近 24 時間を、その間隔で間引いた時間別予報です。

bunx otenki-cli 3h <location...>
bunx otenki-cli 6h <location...>
bunx otenki-cli 12h <location...>
bunx otenki-cli 24h <location...>

現在の時刻の正時から 24 時間先までを、3h なら 3 時間おき、6h なら 6 時間おきに並べます。行数は間隔で決まり、3h は 8 行、6h は 4 行、12h は 2 行、24h は 24 時間後（明日の同じ時刻）の 1 行になります。

$ bunx otenki-cli 3h 函館
函館市 北海道 — 3時間おき（8件）
日時           天気                 気温    降水  確率      風速
────────────────────────────────────────────────────────────────
2026-10-10 16  🌤️ 晴れ            19.8℃  0.0 mm    0%  4.3 km/h
2026-10-10 19  ☀️ 快晴            17.7℃  0.0 mm    0%  6.7 km/h
2026-10-10 22  🌤️ 晴れ            16.5℃  0.0 mm    0%  5.8 km/h

時刻は地点の現地時間です。列は 日時 天気 気温 降水 確率 風速 で、並びと色付けは weekly と同じ規則です（数字は右寄せ、降水と確率は水色、雷雨はマゼンタ、大雨・大雪は太字の赤）。

期間は 24 時間で固定なので、設定ファイルの days はこの 4 コマンドには効きません。

オプション	内容
--json	生 JSON を出力

locate

地名を座標に解決します。天気は引きません。

bunx otenki-cli locate <place...>

$ bunx otenki-cli locate 横浜
横浜市 神奈川県
35.43333, 139.65000
PPLA · 神奈川県 · 日本 · 標高21m

--all を付けると候補が全部表に出ます。順位の上から並ぶので、先頭が既定の候補です。

$ bunx otenki-cli locate 横浜 --all
横浜市 神奈川県
35.43333, 139.65000
PPLA · 神奈川県 · 日本 · 標高21m

地名              都道府県      緯度       経度  種別         人口
──────────────────────────────────────────────────────────────────
横浜市            神奈川県  35.43333  139.65000  PPLA  3,777,491人
横浜              青森県    41.08333  141.25000  PPL       4,412人
横浜              福岡県    33.58608  130.26155  PPLX            -
横浜              熊本県    32.32415  129.99562  PPLL            -
横浜              熊本県    32.48879  130.29495  PPLL            -
横浜市児童遊園地  神奈川県  35.43648  139.57835  PRK             -

人口が不明な候補は - になります。

オプション	内容
--all	候補をすべて表で表示する
--pick	fzf で候補を選ぶ。fzf が無ければエラー
--json	生 JSON を出力。--all なら配列、--pick 併用時は選んだ 1 件

--pick は候補が 1 件だけのときは呼びません。fzf で Ctrl-C を押すと、順位の一番上の場所に戻ります。

表の列は 地名 都道府県 緯度 経度 種別 人口 です。緯度 経度 は数値なので右に寄り、人口 の桁もそろいます。

cache

地名キャッシュの操作。現状は --clear のみです。

bunx otenki-cli cache --clear

$ bunx otenki-cli cache --clear
キャッシュを消去しました

--clear を付けない場合はエラーになり、Usage: を添えて終了コードは 1 です。

保存先は $XDG_STATE_HOME/otenki/places.json、保存期間は 30 日です。詳しくは 地名の指定 を参照してください。

エラー

エラーは stderr に ✗ を付けて出力され、終了コードは 1 です。

$ bunx otenki-cli today mars
✗ "mars" の場所が見つかりませんでした

よくあるメッセージと対処は トラブルシューティング にまとめました。