ドキュメント

サイドバー

4 つのセクションは、どこから来たかではなく、それが何を意味するかで整理されています。いま開いているもの、ブラウズする場所、レビュー中のプルリクエスト、そしてこれまでの足取り。

開いているファイル

作業セットです。Finder から、ドラッグ & ドロップで、⌘O で、コマンドラインから、あるいは「場所」のファイルを確定して—— 明示的に開いたすべての文書が並びます。フラットな一覧で、ドラッグで並べ替えられ、各行はホバーで現れる ✕（または選択して ⌫）で外せます。セクション見出しを右クリックすると 「すべて閉じる」。

プレビュー

「場所」内のファイルをシングルクリックすると、すぐにレンダリングされます——そして「開いているファイル」にはプレビューとして現れます。斜体の 1 行が、つねにセクションの最後に置かれるのです。別のファイルをクリックすればプレビュー行は入れ替わるので、大きなツリーをブラウズしても行が積み上がりません。VS Code のプレビュータブや Xcode の一時エディタと同じ発想で、同じ斜体をまとっています。

読む以上の関わりを見せると、プレビューは普通のピン留め項目になります。

ダブルクリック — ツリー内のファイル、または斜体の行そのもの
編集を始める — 「編集モード」に入るか、ブロック編集を保存するとピン留めされます
右クリックメニューの 「開いたままにする」

読むための操作——blame、行履歴、画像や図の拡大表示——では、プレビューはあえて昇格しません。クリックのたびにファイルを完全に開きたい場合は、設定の「場所」内のファイルをクリックしたときを切り替えてください。

リモートリポジトリも、同じ場所で同じようにプレビューされます。 GitHub リポジトリのツリーをブラウズしても、リモート文書内のリンクをたどっても、「開いているファイル」に現れるのは同じ斜体の 1 行——ただしファイルが Mac 上にないので、本のアイコンと owner/repo @ ref の 2 行目が付きます。プレビューはウィンドウごとにつねに ひとつだけ、ローカルでもリモートでも同じ。何かをプレビューすれば、それまでのプレビューは置き換わります。リモート文書の確定（ダブルクリックまたは「開いたままにする」）は、その文書をリポジトリのもとへ整理すること——「場所」にあるそのリポジトリのピン留めリストに移ります。 ⌘K からは直接ピン留めで開きます。URL を貼り付けるのは、明確な意図だからです。

開いた「場所」の中にある「開いているファイル」の行には、右クリックメニューに 「Location 内に表示」 が加わります。「いま読んでいるもの」から「それが住んでいる場所」への帰り道です。

場所

ブラウズできるルートたち。どこにあるかは問いません。アイコンで区別される 2 種類が同居します。

行	意味
📁 フォルダアイコン	ローカルフォルダ——中の Markdown ファイルをツリーで（右クリック →「リストとして表示」でフラットな一覧でも）。変更は監視されます。
📕 本のアイコン	ブラウズ用に開いた GitHub リポジトリ——API から取得され、ディスクには何も書き込まれません。

git チェックアウトであるローカルフォルダにはブランチチップ（ブランチ記号 + 名前）が生えます。リモートが GitHub なら、小さな閉じた本のマークも付きます——ホバーするとどのリポジトリか分かります。ブランチチップをクリックすると、ブランチとワークツリーのメニューが開きます。

「ワークツリー」 — リポジトリの全ワークツリー。この行のワークツリーにチェックマークが付き、別のものを選ぶと独立した「場所」として開きます。ワークツリーのチェックアウトや切り替えを PullMark が行うことはありません——すでにそこにあるフォルダを開くだけです。
「GitHub のブランチを表示」 — チェックアウトに触れずに、別ブランチのファイルをリモートから読みます。ローカルにワークツリーがあるブランチならそちらへジャンプ—— ローカルがリモートに勝ちます。
「GitHub で開く」 — このブランチのリポジトリをブラウザで。

リモート（本のアイコン）のリポジトリでは、同じチップがブランチを一覧します。 「切り替え先」 はセッションを別ブランチに固定し直し、⌥ を押しながらなら 「ブランチを別に開く」 で並べて読めます。「リポジトリのファイルをブラウズ…」 はリポジトリの Markdown ツリー全体を読み込みます。確定済みの文書はツリーの上に並ぶので、大きなリポジトリに埋もれません。ツリー内に見えている確定済みの文書は、単にそこで表されるだけです。（単にプレビュー中の文書は「開いているファイル」に表示され、ここには現れません。）

パスが解決できなくなったフォルダ（マウント解除されたボリューム、削除されたワークツリー）は、消える代わりに疑問符バッジ付きで淡色表示になり、パスが戻れば自動的に復活します。

プルリクエスト

開いた PR はそれぞれグループになります。概要行（ステータスアイコン + 変更された Markdown の数）に続いて、変更された Markdown ファイルが並び、未解決のレビュースレッドがあるファイルには件数付きのコメントバブルが付きます。開いた PR の下には 「レビューリクエスト」—— あなたのレビュー待ちの PR が集まり、未読数は折りたたんでも見え続けます（設定で非表示にも、 Markdown を変更する PR だけに絞ることもできます）。

PR 行のステータスアイコン。

ステータス	アイコン
ドラフト	プルリクエストの矢印、グレー
オープン	プルリクエストの矢印、緑
マージ済み	マージの矢印、紫
クローズ	✕ の丸、赤
利用不可	ゴミ箱、グレー——PR（またはアクセス権）が失われました

PR 内のファイルごとのマーカーは、追加が + の丸（緑）、削除が − の丸（赤）、リネームが → の丸、変更が鉛筆の丸です。

項目を取り除く

最上位の行にホバーすると ✕ が現れます——外れるのはサイドバーの行だけで、ディスクや GitHub からは何も消えません。選択した行での ⌫ も同じです。「場所」のツリー内のファイルに ✕ はありません。それらは場所の中身であって、サイドバーの項目ではないからです。

アイコン一覧

アイコン	意味
書類	Markdown ファイル
書類、斜体の名前	プレビュー——次のシングルクリックで入れ替わります
フォルダ	ローカルのフォルダまたはディレクトリ
フォルダ + ?	いまは見つからないフォルダ——淡色表示、いずれ復活します
書類 + 時計	行方不明になった最近のファイル
閉じた本	GitHub リポジトリ（行のアイコンとして: リモートでブラウズ中。後ろに付く小さなマークとして: このローカルフォルダはそのチェックアウト）
ブランチ記号 + 名前	ブランチチップ——クリックでブランチとワークツリー
プルリクエストの矢印	プルリクエスト
トレイ	「レビューリクエスト」——あなたのレビュー待ちの PR
吹き出し + 件数	PR のファイル上では、未解決のレビューコメント。「開いているファイル」の行では、文書に残っているマージンノート
色付きドット（左端）	未読のレビューリクエスト
丸の中の ✕（ホバー時）	サイドバーから取り除く／プレビューを閉じる

ブランチ記号が付くのは実際の git 参照だけです（チップとしてのみで、フォルダのアイコンには決してなりません）——フォルダはフォルダ、リポジトリは本、ブランチはブランチです。