miseru CLI / MCP

撮って、PR に見せる。AIエージェントのスクリーンショットを GitHub PR に安全に配信する Miseru のクライアント。

セットアップ

export MISERU_TOKEN=msr_••••   # ダッシュボードで発行

使い方

# PR でスクショを見せる(配信 URL の markdown を標準出力に返す)
npx miseru push ./shot.png --name home --pr 482

# PR に紐づかない共有(メッセージアプリへ貼る・手動共有など)
npx miseru push ./shot.png --name home --context manual:design-review

# PR 全スクショを集約した 1 コメント分の markdown を取得
npx miseru comment --pr 482

# コンテキストを閉じて失効ポリシーを適用する(PR クローズ時など)
npx miseru close --pr 482 --reason merged
npx miseru close --context manual:design-review

# 画像を1枚だけ失効させる
npx miseru expire <image_id>

# ベースラインと比べる(Kurabe)。結果を最大 30 秒待って表示する
npx miseru push ./shot.png --name home --pr 482 --compare

# 比較の結果を見る。--out でベースライン・新規・差分の PNG を保存する
npx miseru diff <image_id> --out ./diff

# 意図した変化なら承認して、ベースラインを置き換える(取り消せない)
npx miseru approve <diff_id>
# ベースラインの一覧を見て、使わなくなったものを消す(取り消せない)
npx miseru baselines
npx miseru baselines delete <baseline_id>

画像は配信コンテキストという単位でまとめられ、その単位で失効します。--pr <n> は --context github_pr:<n> のショートハンドです。コンテキストの型は github_pr(PR 番号がキー)と manual(任意のラベルがキー)。--sha は GitHub 文脈の証跡なので任意です。

comment の markdown には識別マーカー <!-- miseru:pr-N --> が含まれるため、gh api で既存コメントを検索して更新(upsert)すれば 1 PR = 1 コメントに集約できる。

PR への自動コメントは GitHub Action(naoto24kawa/miseru/apps/action)経由で行います。CLI 自体はコメントを投稿せず、標準出力の markdown を返すだけです。

MCP サーバー

{
  "mcpServers": {
    "miseru": { "command": "npx", "args": ["-y", "miseru", "mcp"] }
  }
}

ツール: miseru_push / miseru_comment / miseru_expire / miseru_pause / miseru_resume / miseru_close_context / miseru_diff / miseru_approve / miseru_list_baselines / miseru_delete_baseline