Cmux md katex

Skill YosukeIida/personal-agent-skills/cmux-md-katex

Personal agent skills (Claude Code / Codex) — SKILL.md collection

Install

npx -y skills add YosukeIida/personal-agent-skills --skill cmux-md-katex

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

20 days oldThe repository was created 20 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Markdown ファイル（数式入り）を cmux のブラウザペインで KaTeX 描画してプレビューするスキル。VSCode の Markdown プレビュー相当を cmux 上で再現し、保存ごとに自動更新できる。ターミナル（TUI）には数式を描画できないため別ペインの実ブラウザで表示する。「数式をプレビューして」「この md をブラウザで表示して」「KaTeX で見せて」「数式付き markdown を確認したい」「mdkatex で開いて」などでトリガー。Claude Code 専用。

SKILL.md

4.1 KB, as published. Nobody here has run it

cmux-md-katex

概要

.md ファイルを cmux のブラウザペイン（WKWebView）で 数式込みプレビューするツール mdkatex を Claude から駆動するスキル。markdown-it + KaTeX で VSCode の Markdown プレビューと同じ描画を行い、保存のたびに再レンダリングされる。

ツール本体は dotfiles に同梱済み：

起動スクリプト: ~/workspace/github.com/YosukeIida/dotfiles/cmux/md-katex/cmux-md-katex
zsh 関数: mdkatex（zsh/zshrc で定義）
詳細: cmux/md-katex/README.md

重要な前提：cmux ソケット到達性

cmux browser 系コマンドは cmux アプリの Unix ソケット（と $CMUX_WORKSPACE_ID）を必要とする。Claude Code の Bash シェルがソケットに届くかはセッション依存：

cmux ペイン内で起動された Claude（例: cc-launch-workspace 経由）→ 届く・$CMUX_WORKSPACE_ID も継承され、直接実行できる。
cmux の外で起動された Claude → 届かない（cmux ping が Broken pipe、$CMUX_WORKSPACE_ID が空）。この場合は ユーザーに実行を依頼する。

ワークフロー

対象ファイルを特定し、絶対パスにする。ユーザーが対象を示していなければ、直近で編集・言及した .md を候補として確認する。
到達性を確認する：
```
echo "WS=$CMUX_WORKSPACE_ID"; cmux ping 2>&1
```
- pong 相当が返り $CMUX_WORKSPACE_ID が非空 → 手順 3（直接実行）へ。
- Broken pipe などで失敗、または $CMUX_WORKSPACE_ID が空 → 手順 4（ユーザー依頼）へ。
直接実行（ソケット到達時）。一度だけ描画する（--no-watch で非ブロッキング）：
```
~/workspace/github.com/YosukeIida/dotfiles/cmux/md-katex/cmux-md-katex <絶対パス.md> --no-watch
```
- previewing ... -> surface:N が出れば成功。ブラウザペインに描画されたと伝える。
- その後 Claude がファイルを編集したら、同じコマンドを再実行して更新を反映する。
- 初回のみ generating viewer.html ... が数秒走る（KaTeX を nix から解決）。2 回目以降は一瞬。
- failed to open cmux browser surface 等で失敗したら手順 4 にフォールバックする。
ユーザーに実行を依頼（ソケット不達時）。次をそのまま案内する：
この Claude セッションは cmux ソケットに届かないため、お手元の cmux ターミナルで実行してください：
```
mdkatex <絶対パス.md>
```
（保存ごとに自動更新されます。終了は Ctrl-C。）

補足

継続的なライブ更新が欲しい場合は、ウォッチ版 mdkatex <file>（--no-watch なし）を専用ペインで動かす。これは前面で mtime を監視し続けるので、Claude から cmux send で他人のターミナルに流し込まず、ユーザー自身が実行するのが安全。
Claude が一回ごとに最新状態を見せたいだけなら手順 3 の --no-watch で十分。
同じ .md を再実行すると前に開いたペインを再利用する（surface ref をキャッシュ）。
KaTeX を更新したい / 描画が崩れたら --regen を付けて viewer.html を作り直す。
これは cmux 専用。tmux やその他ターミナルには適用しない（TUI に数式は描画できない）。