MarkuprPlus

MarkuprPlus

見つけたら、伝えるだけ。AI が修正します。

視覚的なフィードバックのための、Windows および macOS 対応デスクトップアプリ、CLI、MCP サーバーです。
デスクトップから録画して注釈を付ける、ターミナルから録画を処理する、または AI エージェントに画面キャプチャツールを提供できます。

Windows または macOS 用をダウンロード · CLI を使う · MCP クライアントを接続 · GitHub Action

▶ 33 秒の製品ツアーを見る

ウィンドウを選び、問題点を説明しながら、発生箇所を丸で囲みます。
丸で囲むたびに、それぞれのスクリーンショットが付いた個別の課題が作成され、コーディングエージェントに貼り付けられる状態になります。

クイックスタート · 一連の流れ · 出力 · スクリーンショット · プロバイダー · MCP · CLI

---

  

Windows では Ctrl、macOS では Cmd を押しながら問題箇所を囲み、そのまま話し続けてください。そのストロークが MX-001 になります。

問題

コーディングエージェントは画面を見ることができません。そのため、作業を中断して説明を入力することになります。レイアウトの不具合を文章で説明し、スクリーンショットを撮り、切り抜いて、適切な場所にドラッグし、どの部分が重要なのか説明します。話す速度は毎分150語、入力する速度は毎分60語です。そのうえ、作業の途中でコンテキストが失われていきます。

解決策

MarkuprPlus は、Windows および macOS 向けデスクトップアプリです。自動化されたワークフロー向けに、CLI、MCP サーバー、GitHub Actionも備えています。デスクトップアプリは Windows のシステムトレイまたは macOS のメニューバーに常駐します。指定したウィンドウを正確に録画し、説明を話している間も音声を録音し、クリックを妨げることなくライブ画面に描画できます。停止すると、デバイス上で文字起こしを行い、言葉と各マークを対応付けて、エージェントが実行に移せるレポートを作成します。囲んだ箇所ごとに1件の指摘があり、それぞれに専用の注釈付きフレームが付属します。

MarkuprPlus の使い方	できること	はじめ方
Windows デスクトップアプリ	画面と音声を録画し、ライブで注釈を描画して、システムトレイからレポートを確認できます。	Windows 版をダウンロード
macOS デスクトップアプリ	Apple Silicon または Intel 搭載 Mac で、メニューバーからキャプチャして注釈を付けられます。	macOS 版をダウンロード
CLI	既存の録画を分析し、フォルダーを監視して、スクリプトでレポートを生成できます。	CLI コマンド
MCP サーバー	AI コーディングエージェントがスクリーンショットをキャプチャし、セッションを録画して、構造化レポートを受け取れるようにします。	エージェントを接続
GitHub Action	GitHub Actions のワークフローで録画を処理できます。	Action の設定

Windows: Ctrl+Shift+F → talk → Ctrl-drag → Ctrl+Shift+F → paste into your agent
macOS:   Cmd+Shift+F  → talk → Cmd-drag  → Cmd+Shift+F  → paste into your agent

操作の流れ

1. キャプチャのショートカットを押して、対象を選択します

Windows では Ctrl+Shift+F、macOS では Cmd+Shift+F を使います。

ピッカーがすべてのウィンドウの手前に開きます。カーソルの下にあるものがハイライトされるので、クリックすると録画対象がそのウィンドウだけに固定されます。移動、サイズ変更、アプリの切り替えを行っても固定されたままです。より広い範囲で指摘を示したい場合は、ワンクリックで領域モードやディスプレイ全体モードに切り替えられます。

セッション中にウィンドウの識別情報やネイティブなジオメトリが曖昧になった場合は、背後にあるものまで範囲を広げるのではなく、キャプチャを停止します。共有するつもりのなかったフレームが送られることはありません。

キャプチャのコントロールは、縦長の1つのポップオーバーにまとめられており、Windows のシステムトレイまたは macOS のメニューバーからアクセスできます。

2. 作業しながら話します

普段どおりアプリをクリックして操作してください。MarkuprPlus はウィンドウとマイクを同時に録音し、停止後にデバイス上で Whisper を使って文字起こしを行います。

ピッカー、描画キャンバス、録画 HUD はすべて OS レベルで画面キャプチャから除外されます。つまり、**MarkuprPlus が描画したものが動画に映ることはありません。**映るのは操作中のアプリだけで、残るのは意図して描いたストロークだけです。

3. Ctrl（Windows）または Cmd（macOS）を押しながら描画します

修飾キーを押しながらドラッグして、ライブ画面に直接描画します。フリーハンド、円、ハイライトから選べ、色も指定できます。キーを離すと、次の通常のクリックは下のアプリに届くと同時にマークを保存し、キャンバスが次のマーク用にクリアされます。

円が3つなら、問題も3件です。3つの落書きがあるスクリーンショット1枚にはなりません。各指摘には専用の PNG、タイムスタンプ、ツール、色が付属します。

### 4. キャプチャのショートカットをもう一度押して停止します

Windows では Ctrl+Shift+F、macOS では Cmd+Shift+F を使います。

Whisper が実行され、ナレーションが各マークに合わせて配置されると、レポートがディスクに書き込まれます。準備ができた瞬間にマークダウンのパスがクリップボードにコピーされます。Claude Code、Codex、Cursor など、ファイルを読み込めるものにそのまま貼り付けてください。

セッションのすべてのデータは 1 つのフォルダーに保存されます。レポート、スクリーンショット、セッション動画、ナレーション音声、メタデータが含まれます。

クイックスタート

Windows および macOS デスクトップアプリ（推奨）

markuprplus.com またはリリースページからダウンロードしてください。Apple Silicon または Intel 用の Windows インストーラー（.exe） または macOS ディスクイメージ（.dmg） を選択します。

macOS のインストールに関する注意： GitHub Releases から直接ダウンロードできるファイルには、署名、公証、チケットの付与が行われています。Gatekeeper によってファイルが拒否された場合は、MarkuprPlus サポートに連絡して、リリースを調査できるようにしてください。

1. Cmd+Shift+F（macOS）または Ctrl+Shift+F（Windows）を押して、目的のウィンドウをクリックします。
2. 画面に見えている内容をナレーションします。Cmd / Ctrl を押しながらドラッグすると、表示中の画面にマークを付けられます。
3. キーを離してから通常どおりクリックすると、マークが保存され、キャンバスがクリアされます。問題を見つけるたびに繰り返します。
4. ホットキーをもう一度押して停止します。レポートのパスはクリップボードにコピーされています。

MCP サーバー（AI コーディングエージェント向け）

npx --yes --package markuprplus markuprplus-mcp

CLI（既存の録画向け）

npx markuprplus analyze ./recording.mov

互換性： 公開パッケージとコマンドは markuprplus および markuprplus-mcp です。既存の .markuprx プロジェクトファイル、ストレージパス、アプリの 識別子は変更されないため、アップグレード後も設定とセッションが引き継がれます。

Mac App Store 版 CLI 連携用のオプションのコンパニオン

サンドボックス化された Mac App Store アプリは、オプションの MarkuprPlus CLI Bridge を通じて、Mac にすでにインストールされ、サインイン済みの AI コマンドラインツールを使用できます。Local Rules、Ollama、LM Studio、Anthropic API では、このコンパニオンは必要ありません。

ターミナルからインストールしてペアリングします。

npm install -g markuprplus
markuprplus bridge install     # installs and starts a per-user LaunchAgent
markuprplus bridge token       # paste this value in Settings → Advanced
markuprplus bridge status

公開 npm パッケージには、ソースリリースと同じバージョンの CLI と MCP エントリポイントが含まれています。

サービスは 127.0.0.1:49647 のみで待ち受け、すべてのプロバイダーリクエストでランダムなペアリングトークンを要求します。また、シェルのテキストではなく、固定の構造化レポートプロトコルを受け付けます。App Store 版アプリはシェルコマンドを実行したり、外部ツールを起動したりしません。別途インストールするコンパニオンは、「設定」で選択したプロバイダーのみを呼び出します。

ライフサイクルと復旧用のコマンド：

markuprplus bridge start
markuprplus bridge stop
markuprplus bridge status
markuprplus bridge token
markuprplus bridge rotate-token
markuprplus bridge uninstall

トークンをローテーションすると、再度ペアリングが必要です。アンインストールすると、MarkuprPlus が所有する LaunchAgent とブリッジ設定のみが削除されます。AI CLI はアンインストールされません。

フォルダーに保存されるもの

1 セッションにつき 1 つのディレクトリです。

originplayer-test-iphone-20260818-104731/
├── feedback-report.md          # the file you paste
├── feedback-summary.md         # counts and duration
├── metadata.json               # per-issue capture context
├── processing-trace.json       # which provider ran, how long, why it fell back
├── screenshots/
│   ├── marked-issue-001.png    # one frame per mark, your stroke composited in
│   ├── marked-issue-002.png
│   └── marked-issue-003.png
├── session-recording.webm      # the window, with annotations
└── session-audio.webm          # your narration

そのセッションで実際に記録された、未編集の問題の例：

### MX-001

- **Timestamp:** 00:08
- **Tools:** freehand
- **Colors:** #ff3b30

#### User Comment

> So there's a search menu and over here by default, if there's been
> previous searches, it should list out all the searches that have
> happened in the past.

#### Marked Evidence

![Marked issue MX-001](./screenshots/marked-issue-001.png)

各問題には、画像以外にも次の情報が含まれます。

問題とともに保存される情報	例
個別に注釈が付けられた PNG	screenshots/marked-issue-001.png
その時点のナレーション	transcript-segment-0001 … 0002
マークの付け方	freehand · #ff3b30
発生元	window:5976:0 · OriginPlayer Test iPhone · darwin
カーソル、アクティブなアプリ、フォーカスのヒント	描画した瞬間にキャプチャ
トリガーのメタデータ	annotation、manual、pause、voice-command

マークを付けた問題には MX-001…、ナレーションのみから生成された項目には FB-001… の番号が付けられます。

あらゆる画面

レポートプロバイダー セッションをレポートに変換する15種類の方法があり、それぞれのプロバイダーが現在利用可能かどうかを表示します。CLI のバージョンとパス、ローカルポート、キーの不足などを確認できます。	レビューエディター 指摘事項の順序やタイトルを変更し、カテゴリと重要度を編集できます。考えを声に出していただけの指摘は削除できます。	ライブ Markdown プレビュー 保存する前に、エージェントが読み取るファイルをそのまま確認できます。コピーしたり、フォルダーを開いたり、エクスポートしたりできます。
最近のキャプチャ 各セッションは項目数とショット数とともにディスク上に保存されます。Finder を探し回らなくても、レポートのパスをコピーして戻せます。	ホットキー 録画、スクリーンショット、一時停止のホットキーはグローバルに使え、割り当てを変更できます。クイックリファレンスはパネル内で確認できます。	外観 10色のアクセントカラーとカスタム選択機能があり、選択内容をリアルタイムでプレビューできます。ライトモードとダークモードはシステム設定に従います。
録画とオーディオ 録画開始前のカウントダウン、音声波形のフィードバック、マイクの選択ができます。	文字起こしとキー まず Whisper をローカルで実行します。ローカルでの復旧に失敗し、かつキーを保存している場合に限り、OpenAI に音声が送信されます。	メニューバー ポップオーバーを開かずに、録画の開始、設定への移動、アプリの終了ができます。

ローカル文字起こし

デスクトップアプリの起動時にローカルモデルがインストールされていない場合、MarkuprPlus は多言語対応の Whisper tiny モデル（約75 MB）をバックグラウンドでダウンロードします。既存のモデルは再利用されます。 ダウンロードの進行状況と再試行可能なエラーは、 Settings > Advanced > Local Transcription に表示されます。中断されたダウンロードは 次回の起動時に再開されます。オフライン時やダウンロードに失敗した場合でも、アプリの起動は妨げられません。 ダウンロード後は、インターネット接続なしでローカル文字起こしを利用できます。

インターフェース言語

デスクトップインターフェースは、以前は自動的に繁体字中国語で表示されていたインストール環境からアップグレードした場合も含め、デフォルトで英語に設定されています。Settings > General > Language > Interface languageを選択すると、繁体字中国語に切り替えるか、英語に戻せます。この設定は保存され、再起動や録音の中断なしに、開いているすべてのウィンドウにすぐ反映されます。General settingsをリセットすると、英語に戻ります。

インターフェース言語は、文字起こしの言語とは別の設定です。この設定を変更しても、フィードバックのテキスト、録音、生成されたレポートは翻訳されません。

別のインターフェース言語を追加するには、src/shared/uiLanguage.tsに言語識別子と表示名を登録し、src/renderer/i18n/catalogs.tsに翻訳カタログを追加します。英語のラベルは翻訳元であり、翻訳がない場合のフォールバックとして使用されます。ユーザーコンテンツの領域にはtranslate="no"を指定してください。

レポートプロバイダー

キャプチャを構造化レポートに変換するモデルを選択します。MarkuprPlus は記録前に各モデルを確認し、実際に検出した内容を表示します。

Mac App Store アプリでは、CLI プロバイダーは前述のオプションのローカルコンパニオンを使用します。直接配布されるデスクトップビルドでは、アプリ内で同じアダプターを呼び出します。どちらの場合も、失敗時に備えたレポートとしてローカルルールが保持されます。

プロバイダー	種類	使用するもの
Codex CLI	CLI	インストール済みの CLI、または Codex Mac アプリにバンドルされた CLI と既存の ChatGPT ログイン情報を使用する、読み取り専用の一時セッション
Claude Code CLI	CLI	すでにサインインしている Claude Code CLI
GitHub Copilot CLI	CLI	既存の GitHub ログイン情報を使用する、分離されたツールなしのセッションでの Copilot CLI 1.0.83 以降
OpenCode	CLI	設定済みの OpenCode プロバイダーと、すべてのツール操作を拒否する実行ごとのエージェント
Cursor Agent CLI	CLI	非対話型の読み取り専用 Ask モードでの Cursor Agent
Qwen Code	CLI	変更用ツールを除外した、安全な非対話型の plan モードでの Qwen Code
Goose	CLI	プロファイルやセッションの永続化を使用しない、ツールなしのチャットモードでの設定済み Goose プロバイダー
Amp	CLI	分離されたデフォルト拒否のツールポリシーを使用する Amp ログイン情報
Kiro CLI	CLI	読み取りと grep のみを信頼する Kiro のヘッドレスモード
Aider	CLI	dry-run、no-git モードでの設定済み Aider モデル
Ollama	ローカル	127.0.0.1:11434 で提供されるモデル。マシン外にデータは送信されません
LM Studio	ローカル	127.0.0.1:1234 の LM Studio サーバー
Anthropic API	クラウド	システムキーチェーンに保存され、それ以外の用途には使われないユーザー自身のキー
ローカルルール	設定不要	トランスクリプトとマークのみから生成される決定論的なレポート。認証情報は不要です

失敗しても安全な設計です。 選択したプロバイダーでエラーが発生した場合でも、決定論的なローカルルールのレポートが必ず書き込まれ、ポップオーバーにはプロバイダー名と理由が表示されます。分析が始まる前に、録画、音声、マークはすでにディスクに保存されています。明示的に選択した CLI が、Anthropic の呼び出しに黙って切り替わることはありません。

Codex CLI、GitHub Copilot CLI、OpenCode には、キャプチャしたスクリーンショットを渡せます。トランスクリプトのみを扱う CLI アダプターでは、スクリーンショットのみのセッションを拒否し、視覚的な所見を捏造しません。

GitHub Copilot CLI を使用するには、copilot をインストールまたは更新し、ターミナルで copilot login を実行してから、レポート設定で GitHub Copilot CLI を選択し、プロバイダーを更新します。モデル欄を空欄にすると Copilot のデフォルトが使われます。Copilot のモデル ID を入力することもできます。検出時にインストール済みバージョンが確認され、認証はレポートの実行時に確認されます。オプションの CLI Bridge を使うと、Mac App Store アプリでも同じ連携を利用できます。

Copilot には、標準入力経由でトランスクリプトが渡され、スクリーンショットは添付ファイルとして渡されます。各レポートでは、一時的な Copilot 設定が使われます。この設定で再利用されるのは、ログイン ID（認証情報は OS の認証情報ストアに保持されます）とデフォルトモデルのみで、プラグイン、フック、MCP サーバー、保存済みの権限は再利用されません。すべてのモデルツールとカスタム指示は無効になります。一時的なコンテキストは、成功時も失敗時も削除されます。環境変数トークンによる認証にも対応しています。平文の認証情報を代替手段として一時設定にコピーすることはありません。

processing-trace.json には、実際に行われた処理がそのまま記録されます。

{
  "requestedProvider": "codex-cli",
  "actualProvider": "rules",
  "aiFallbackReason": "Codex analysis exited with status 1.",
  "aiEnhanced": false,
  "totalMs": 4220
}

MarkuprPlus を選ぶ理由

映像ではなく、証拠を。 画面録画を渡しても、エージェントはその動画を見られず、あなたは内容を二度説明することになります。このツールでは、調査結果ごとに注釈付きのフレーム、該当するタイムスタンプで話した言葉、ウィンドウとカーソルのコンテキストを個別に確認できます。

ローカル優先。 Whisper はデバイス上で動作し、Local ルールには認証情報が必要ありません。クラウド文字起こしやクラウドモデルが動作するのは、明示的に選択した場合のみです。アカウントも、テレメトリーも、分析もありません。

アプリ自身は録画されません。 ピッカー、描画キャンバス、録画 HUD は、OS レベルでコンテンツ保護されています。描き込んだマークはレポートに反映されますが、アプリ自体の UI が動画に映ることはありません。

ワークフローに適合。 日々のキャプチャ用デスクトップアプリ（Windows および macOS）、スクリプトや CI 用の CLI、エージェント用の MCP サーバー、プルリクエスト用の GitHub Action を提供しています。

オープンソース。 MIT ライセンスです。コードを読み、フォークし、リリースできます。

MCP サーバー

エージェントに目と耳を与えましょう。スクリーンショットの撮影、音声付きの画面録画、会話中の構造化レポートの受け取りができます。

セットアップコマンドを使って、GitHub Copilot CLI、Claude Mac アプリ、または Codex を接続します。

npm install -g markuprplus
markuprplus integrate copilot
markuprplus integrate claude-desktop
markuprplus integrate codex

使用する各クライアントでコマンドを実行し、その後クライアントを再起動してください。Claude のセットアップは Chat と Code の両方に対応しています。Codex は CLI と設定を共有します。--dry-run を追加すると、変更内容を事前に確認できます。既存の設定や他のサーバーは保持され、変更されたファイルはバックアップされます。既存の markuprplus エントリーと競合する場合は、--force が必要です。詳しくは、クライアントのセットアップと機能をご覧ください。

手動でセットアップする場合、Claude Code（~/.claude.json またはプロジェクトの .mcp.json）、Cursor、Windsurf では、次の形式を使用します。

{
  "mcpServers": {
    "MarkuprPlus": {
      "command": "npx",
      "args": ["--yes", "--package", "markuprplus", "markuprplus-mcp"]
    }
  }
}

ツール

ツール	説明
capture_screenshot	カーソル、アクティブなアプリ／ウィンドウ、フォーカスのヒントを含めて、現在の画面をキャプチャします。
capture_with_voice	指定した時間、画面とマイクを録音し、構造化レポートを返します。
describe_screen	現在画面に表示されている内容を説明します。
start_recording	対話型の録画セッションを開始します。
stop_recording	セッションを終了し、パイプライン全体を実行します。
analyze_video	既存の .mov／.mp4 を処理し、抽出したフレームを含む Markdown に変換します。
analyze_screenshot	1 枚のスクリーンショットを分析パイプラインで処理します。
push_to_github	レポートから GitHub イシューを作成します。
push_to_linear	レポートから Linear イシューを作成します。

You: "The sidebar is overlapping the main content on mobile. Can you see it?"

Agent: [calls capture_screenshot]
       "I can see it — the sidebar is position: fixed with no z-index,
        280px wide with no responsive breakpoint. Fixing the CSS..."

MCP の完全なドキュメントはこちらです：README-MCP.md。

CLI

npx markuprplus analyze ./recording.mov

コマンド	機能
markuprplus analyze <video>	既存の録画を構造化レポートに変換します
markuprplus watch [dir]	フォルダーに新しい録画が追加されると処理します
markuprplus doctor	依存関係と設定を確認します
markuprplus init	設定のひな形を作成します
markuprplus push github <report>	レポートから GitHub イシューを作成します
markuprplus push linear <report>	レポートから Linear イシューを作成します

markuprplus analyze ./recording.mov --output ./reports
markuprplus analyze ./recording.mov --template github-issue
markuprplus analyze ./recording.mov --no-frames        # transcript only
markuprplus watch ~/Desktop --output ./reports
markuprplus push github ./report.md --repo myorg/myapp --dry-run

出力テンプレート： markdown（デフォルト）・json・github-issue・linear・jira デスクトップアプリでは、html と pdf もエクスポートできます。

要件： Node.js 20.9+ と、PATH 上の ffmpeg（brew install ffmpeg／apt install ffmpeg／choco install ffmpeg）。

インテグレーション

GitHub Action

CI で録画を分析し、フィードバックが必要なプルリクエストに構造化された情報を投稿できます。

- uses: eddiesanjuan/markuprx-action@v1
  with:
    video-path: ./recordings/
    github-token: ${{ secrets.GITHUB_TOKEN }}
    create-issues: 'true'

各入力項目については、markuprx-action/README.mdをご覧ください。

イシュートラッカー

アプリ、CLI、または MCP 経由のエージェントから、各調査結果をスクリーンショット、ナレーション、タイムスタンプ、キャプチャ時のコンテキストとともに整形して、GitHub Issues または Linear に直接登録できます。

キーボードショートカット

操作	macOS	Windows
録画の開始／停止	Cmd+Shift+F	Ctrl+Shift+F
ライブ画面にマークを付ける	Cmd を押しながらドラッグ	Ctrl を押しながらドラッグ
手動スクリーンショット	Cmd+Shift+S	Ctrl+Shift+S
一時停止／再開	Cmd+Shift+P	Ctrl+Shift+P
設定	Cmd+,	Ctrl+,

録画、スクリーンショット、一時停止のショートカットはグローバルで、設定 → ホットキーから再割り当てできます。詳しくは、docs/KEYBOARD_SHORTCUTS.mdを参照してください。

仕組み

                    +-----------+
  Screen + Voice -> | Whisper   | -> Timestamped transcript
                    +-----------+
                         |
                    +-----------+
                    | Aligner   | -> Marks matched to the words around them
                    +-----------+
                         |
                    +-----------+
                    | Provider  | -> Structure and severity (or local rules)
                    +-----------+
                         |
                    +-----------+
                    | Generator | -> Markdown, HTML, JSON, PDF, or tracker-ready
                    +-----------+

パイプラインは各段階で柔軟に処理を継続します。ffmpeg がない場合は、文字起こしのみの出力になります。Whisper モデルがない場合は、タイマー式のスクリーンショットを使用します。プロバイダーがない場合は、ローカルルールを使用します。どこで障害が発生しても、レポートと未加工のセッションがディスクに残ります。

アーキテクチャの詳細については、CLAUDE.mdを参照してください。

開発

npm install
npm run dev

コマンド	説明
npm run dev	ホットリロードを使った開発モード
npm run build	すべてをビルドします（デスクトップ＋CLI＋MCP）
npm test	すべてのテストを実行します
npm run lint	リントを実行します
npm run typecheck	型チェックを実行します

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/your-feature
3. テストを実行します：npm test && npm run lint && npm run typecheck
4. プルリクエストを作成します

詳しいガイドラインについては、CONTRIBUTING.mdを参照してください。

ライセンス

MIT — LICENSEを参照してください。

---

www.markuprplus.com