---
title: 2.5.3 で変わったこと
layout: default
parent: 日本語
nav_order: 1024
---

# 2.5.3 で変わったこと
{: .no_toc }

**2026-07-28** 時点のスナップショットとして書いています。挙動は動きますが、このページは動きません。
最新の内容は各節からリンクしているリファレンスを見てください。

- TOC
{:toc}

---

## 1 つだけ読むなら

**上げてください。** 裏で動く probe（使用量ゲージ用）が 90 秒ごとに再発火し続けることがあり、
**ゲージが表示しているまさにその Claude 予算**を使い続けていました。報告者の環境では 30 分で
21 回、セッション一覧 50 件のうち 41 件がその残骸でした。設定は要りません。2.5.3 を入れれば直ります。

```bash
npx mulmoterminal@latest
```

新機能は 2 つで、どちらも**自分で on にするまで動きません**: ターミナルへ生のキー列を送る
（`keymap.send`）と、プロジェクトで既に決めたことの要約（`decisionDigest`）です。

---

## 使用量ゲージが予算を食い潰さなくなる

**設定することはありません。**

### 何が壊れていたか

ゲージ（右上の `5h` / `7d`）は、隠れた Claude セッションを 1 つ起動してステータスラインから
数値を読みます。そのセッションが何も返さなかったとき、**試行したことがどこにも記録されず**、
「手元の値が古い」という判定だけが真のまま残り、次のポーリングが即座に次の probe を始めていました。
起動するたびに、あなたの窓に対する本物のクエリが 1 回消費されます。

### 修正が入っているかの見分け方

**Claude の数値を出せないとき、その理由が出るようになりました。** 数値の位置に
`claude usage n/a` と出て、hover すると次のいずれかが読めます。

| hover で出る文言 | 意味 |
|---|---|
| the `claude` command was not found on PATH | probe する相手がいません。`claude` を入れれば**再起動なしで**復帰します |
| this account reports no 5h / 7d windows (API-key billing) | 構造的な理由です。API キー課金には報告すべき窓がありません。課金形態が変わる場合に備えて 1 時間に 1 回ほど聞き直します |
| the last check got no answer. Retrying, less often each time | 信頼プロンプトが未応答、ログイン切れ、あるいは起動が遅い。90 秒 → 3 分 → 6 分 … 最大 1 時間まで間隔を広げます |

これまでは「まだ測っていない」と「ここでは測れない」が見分けられませんでした。暴走が 30 分間
誰にも気づかれなかったのは、まさにそのためです。

### probe が残していたセッション

probe の使い捨てセッションは、セッション一覧に出なくなりました。

**アップグレード前に作られた分は残ります。** それらはランダムな id で書かれていて、あなたの
セッションと見分ける手がかりがなく、安全に選り分けられないためです。`claude --resume`
（Claude 自身の履歴）にも残ります。2.5.3 で変わるのは**増えなくなること**です。既にあるものの
掃除は [#1010](https://github.com/receptron/mulmoterminal/issues/1010) で追っています。

---

## ターミナルへ生のキー列を送る（`keymap.send`）

こちらは **opt-in**。発端は Mac の `Cmd+→` で行末へ移動したい、でした。

`keymap` の他の項目は、キーを**アプリの動作**に結びつけます。`send` は違って、フォーカスされた
ターミナルに**バイト列**を入れます。シェルやエディタが既に理解しているものを、そのまま割り当てられます。

1. `~/.mulmoterminal/config.json` を開きます。
2. `keymap` の中に `send` を足します:

   ```json
   {
     "keymap": {
       "send": [
         { "key": "Cmd+ArrowRight", "bytes": "\u0005" },
         { "key": "Cmd+ArrowLeft",  "bytes": "\u0001" }
       ]
     }
   }
   ```

3. **`mulmoterminal` を再起動**し、ブラウザのタブも読み込み直します。
4. ターミナルをクリックして `Cmd+→` を押すと、カーソルが行末へ飛びます。

`bytes` は PTY に**そのまま**渡ります。制御文字は JSON の書き方で書くので、`"\u0005"` が
Ctrl+E（行末）、`"\u0001"` が Ctrl+A（行頭）です。こちらで解釈やエスケープのし直しはしません。
`Cmd` / `Command` / `Meta` は同じ修飾キー、`Option` は Alt の macOS 名です。

書き方が間違っていれば、変なものを割り当てる代わりに起動時に指摘します。

割り当てられる動作の一覧と修飾キーの表記は [キーボードショートカット](config.html#keymap) に
あります。

---

## このプロジェクトで既に決めたこと（`decisionDigest`）

こちらも **opt-in** で、このリリースでガイドに書かれました。

先週決めたことをもう一度聞いてくるエージェントは、学習していません。on にすると、このプロジェクトの
セッションが**実際に人間へ聞いた質問** — 提示した選択肢と、どれが選ばれたか — を Markdown に
まとめ、似たことを聞く**前に**読ませられます。

1. `~/.mulmoterminal/config.json` を開きます。
2. 足します:

   ```json
   { "decisionDigest": true }
   ```

3. **`mulmoterminal` を再起動**します。このキーは Settings に画面が無く、ファイルは起動時に
   一度だけ読まれます。
4. `~/.mulmoterminal/decisions/<project>.md` を見てください。起動時と 6 時間ごとに、このホストが
   実際に作業しているディレクトリについて書き直されます。

リポジトリの中には決して書きません。中身は**日付つきの事実だけで、推論した規則は書きません** —
「この人はいつも推奨案を選ぶ」はそれらしく読めてしまい、しかも間違っていることがあり、
**間違った学習が黙って効くのが一番まずい**からです。**どの選択肢も選ばず自分で書いた**回答も
残します。むしろそちらが読む価値のある記録です。質問そのものが的外れだった、という事実なので。

エージェント側は同梱スキル `mulmoterminal-decisions` 経由で読みます。他の同梱スキルと同じく
`~/.claude/skills/` にミラーされます。

リファレンス: [このプロジェクトで既に決めたこと](config.html#decision-digest)

---

## 何もしなくても直っているもの

| 何が壊れていたか | 直ったことの確かめ方 |
|---|---|
| **プロジェクトの色が Claude セルにしか効かなかった。** `.mulmoterminal.json` のクローム色 6 キーが Shell（launcher）と Command セルでは何もせず、黙って既定色に落ちていた | クローム色を設定したディレクトリで Shell セルか Run セルを開く。隣の Claude セルと同じように色が乗る |
| **末尾スラッシュ付きの `cwd` でライブリロードが届かなかった。** `/path/to/repo/` で開いたセルには `.mulmoterminal.json` の変更が反映されない。1 つのディレクトリが 2 つの名前を持ち、通知が別名の方へ飛んでいた | `.mulmoterminal.json` を編集して、パスの書き方に関わらずリロードなしでセルが変わることを確認する |
| **サーバ再起動を生き延びたセッションが、スマホでフォルダを失っていた。** tmux にだけ残っているセッションが `cwd` も作業項目も持たずに並ぶ | セッションを走らせたままサーバを再起動し、スマホ表示を開く。行がフォルダを覚えている |

このリリースには他に、スマホのセッション一覧が各セルの issue / PR（番号・タイトル・フェーズ）を
データとして持つようになった件と、このリポジトリの CI がハングしたレビュージョブを 15 分待たなく
なった件が入っています。

---

## リンク

- 変更の全一覧: [ChangeLog](https://github.com/receptron/mulmoterminal/blob/main/docs/ChangeLog.md)
- 設定の全項目: [設定](config.html)
- 機能の一覧: [機能一覧](features.html)
