既知の制限

カーソルクリック移動と全角文字

全角文字（日本語など）を含む行では、クリックした位置とカーソルが移動する位置がずれることがあります。

これは Calyx 固有の問題ではなく、Ghostty の cursor-click-to-move が、クリック座標を「ターミナルセル単位の矢印キー入力」に変換する仕組みに起因します。全角文字が複数セルを占めるため、変換時に誤差が出ます。

回避策はありません。全角を多用する行ではキー入力でカーソルを移動してください。

Calyx が上書きする Ghostty 設定キー

Liquid Glass UI を成立させるため、次のキーは Calyx が上書きします。 Ghostty 設定ファイルに書いても反映されません。

background-opacity
background-blur
background-opacity-cells
foreground

現時点で Calyx が管理しているキーの完全な一覧は、Settings の Ghostty Config Compatibility で確認できます。

background-opacity-cells もここで上書きされますが、Calyx 側から設定する手段があります。 Settings の Appearance にある専用のスイッチから設定してください。詳細はガラスの不透明度を参照してください。

fish で停止中のジョブがあるときのエージェント行

Calyx はペインのシェルがプロンプトに戻った時点でエージェントの行を完了にしますが、Ctrl-Z で中断したコマンドは対象から外します。 fish には、停止中のジョブがどのコマンドのものかを知る手段がありません。そのため fish のペインに停止中のジョブが一つでも残っているあいだは、そのあとに実行した無関係なコマンドも中断として扱われ、そのペインの行は完了にならずに残ります。 fg で再開するか、そのジョブを終了させると解消します。コマンドログは影響を受けません。各コマンドは自分自身の終了コードをそのまま記録します。

Codex のサブエージェントの行

Calyx は Codex が文書化している SubagentStart と SubagentStop のフックを購読していますが、実際の Codex の実行でこれらのフックを捕捉できたことはまだありません。 Claude Code、Grok、OpenCode のサブエージェントの行は実際のセッションで確認していますが、Codex では行が出ない可能性があります。

Mission Map での herdr のエージェント

herdr がホストするエージェントはエージェントサイドバーには並びますが、Mission Map はそれを読み取りません。そのペインは Mission Map では薄く表示された Terminal のカードになり、エージェント名も状態も出ません。

Claude Code の使用量の合計

Usage Tracking が数えるのは、オンの間に開始した Claude Code のセッションだけです。 Claude Code がテレメトリの設定を読むのは起動時だからです。すでに動いていたセッションは再起動してください。 Calyx が動いていない間に開始して終了したセッションは、まったく数えられません。

記録対象のセッションが Calyx の停止中に使ったトークンは、Calyx がその Claude Code のプロセスから次に受信したときに加算されます。その前にプロセスが終了していた場合は、その実行の終了時点の日付で、モデルごとの unreported の行として現れます（effort とスレッドは付きません）。

usage_report では、利用者が自分で定義したエージェントは、エージェントの種類が custom として現れます。 Claude Code がその名前で報告するためです。

~/.claude/settings.json ではなくシェルの環境変数で設定したテレメトリを、Calyx は検出しません。

Calyx の再起動後にサーバーが以前と異なるポートで起動した場合、それより前に開始した Claude Code のセッションは古いポートへ送り続けます。そのセッションは再起動してください。

この機能がない Calyx（0.45.1 以前）に戻す前に、Usage Tracking をオフにして、Calyx が ~/.claude/settings.json に追加した設定を取り除いてください。

リモートセッションでのセキュア入力

ローカルの永続セッションでは、パスワード入力待ちになると Calyx が自動で Secure Keyboard Entry を有効にします。リモートセッションではこの自動切り替えが働きません。パスワードを入力する前に、アプリメニューから Secure Keyboard Entry をオンにしてください。

クイックターミナルで動く herdr TUI

Session Browser の Show では、クイックターミナルで動いている herdr TUI にフォーカスを移せません。

ダウングレード後のセッション復元

Calyx 0.44.0 は、Mission Map のカードの位置を含められる新しい形式でウィンドウのレイアウトを保存します。 Calyx 0.43.0 以前はこの形式で保存されたレイアウトを破棄するため、0.44.0 以降を使ったあとで古いバージョンに戻すと、前回のタブとスプリットは復元されず、新しいウィンドウから始まります。

ブラウザタブの制約

対応プロトコルは http / https のみ
ストレージは非永続（タブを閉じると Cookie やローカルストレージは破棄）
ポップアップウィンドウは自動でブロック

汎用ブラウザではなく、開発・自動化向けのビューと位置づけられています。