# Macデスクトップアプリ

> **ベータ版です。** 動作や画面が予告なく変わることがあります。

Web版と同じ機能を、Mac用のアプリから使えます。中身は本番サイトを開くだけの薄いアプリなので、画面の更新はWebのデプロイに追随します。配布は **macOSのみ** です（Windowsは未対応）。

## 入手と起動

- ベータ期間中は、配布ファイルを**メールでお送りしています**。トップページの **Mac版（ベータ）を申し込む** からメールアドレスを登録すると、ダウンロード用のURLが届きます。
- インストール後、Dockから起動してWeb版と同じアカウントでログインします。

## ブラウザからデスクトップへ渡す

ブラウザで **コンソール** (`/console`) または **ログイン・認証** (`/auth`) を開いたとき、デスクトップアプリが入っていれば **デスクトップアプリで開く** の案内が全画面で出ます。

- **デスクトップで開く** — 同じ画面をデスクトップアプリで開きます。案内のあいだ、ブラウザ側では作業UIを重ねて表示しません（ブラウザとデスクトップで同じ画面が二重に見えるのを防ぐため）。
- **ブラウザで続ける** — このブラウザではWeb版のまま使います。選んだあと、この案内は再び出ません（Webからデスクトップを開く入口はこの画面だけのため、アプリはDockなどから直接起動してください）。

初回は案内を出したうえで、デスクトップ版があれば **自動で開く試みをタブ内で1回だけ** 行います。ログイン画面へ付け替わっても、最初に開いたURLだけ渡します。

デスクトップアプリ**内**では案内は出ません。LPや使い方ガイド (`/docs`) のURLからは案内しません。

## 共有リンクはhttpsのまま

Slack、MCP、画面のコピーリンクなど、共有するURLは従来どおり `https://pmonrails.com/...` です。デスクトップへ渡すのは、自分のブラウザでコンソールや認証URLを開いたときだけです。

## メニューバー常駐とクイック起票

ウィンドウを閉じてもアプリは終了せず、メニューバーに残ります。

- **Command+Shift+D**（変更可）— 小さな入力窓から、直近のプロジェクト向けに要求カードを1枚起票できます。未ログインのときはログイン画面を開きます。
- **終了** — メニューバーの「終了」またはCmd+Qです。

## 通知

アプリを起動している間、未読通知が増えるとmacOSの通知センターへ届き、Dockアイコンに件数が付きます。通知をクリックするとアプリが前面に出て該当画面を開きます。アプリを終了している間のプッシュ通知は行いません（Web版のメール・ダイジェストなどは従来どおり使えます）。

## テスト結果の証拠

[テスト](https://pmonrails.com/docs/test-results.md)画面で手動記録するとき、証拠の画像・動画はファイル選択に加え**クリップボード貼り付け**（Cmd+V）でも添付できます。

## タスクへのディープリンク

デスクトップアプリは `pmr://task/<タスクID>` を受け取ると前面に出て、そのタスク詳細を開きます（通知や外部ツールからのジャンプ用。ブラウザ共有URLとは別系統です）。

## オフライン

ネットワークに繋がらないときは、接続できない旨と再試行だけを表示します。オフラインでの閲覧・編集はできません。

## 更新

アプリ本体（シェル）に新しい版があるとき、コンソール内にダウンロード導線が出ます。機能そのものはWeb側の更新に追随します。

## 次のステップ

- 初めて使う → [クイックスタート](https://pmonrails.com/docs/quickstart.md)
- 通知の受け取り方 → [通知とSlack](https://pmonrails.com/docs/notifications.md)

---

https://pmonrails.com/docs/desktop