ドキュメント

サイドバー

セクションは、どこから来たかではなく、それが何を意味するかで整理されています。いま開いているもの、残しておく場所、ブラウズする場所、自分に関わるプルリクエストと Issue、そしてこれまでの足取り。

開いているファイル

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

プレビュー

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

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

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

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

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

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

ピン留め済み

何度も立ち返るフォルダとファイルを、Finder が「よく使う項目」をすべての上に置くのと同じように、「場所」の上に置いておけます。どのツリーでもフォルダやファイルを右クリックして 「ピン留め…」を選びます。フォルダは独自のツリーを持つ独立したルートになり、ファイルはクリックでプレビューするブックマーク行になり、新しい項目はセクションの一番下に名前変更の状態のまま現れます。「場所」のルートには「ピン留め」が現れ（選ぶとここに移動します）、ピン留め済みのルートには「ピン留めを解除」が現れます（名前はそのままに「場所」の一番下へ移動します）。

名前の変更は Finder と同じ流儀です。「名称変更…」を選ぶか、選択した行で Return を押し、入力して Return、どこか他をクリック、あるいは次へ移動すると確定します。Escape でキャンセル、空にしたフィールドは元の名前に戻ります。名前を変更した項目は、名前の下に小さな文字で本当のパスを表示します。同じ名前を持つルートのペアも同様に表示されるので、 docs という名前のフォルダが 2 つあっても見分けがつかなくなることはありません。ピン留めした項目は環境設定であり、セッションの一部ではありません—— 「起動時に前回のセッションを開き直す」の設定にかかわらず、起動のたびに戻ってきます。

場所

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

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

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

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

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

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

プルリクエスト

開いた PR はそれぞれグループになります。概要行（ステータスアイコン + 変更された Markdown の数）に続いて、変更された Markdown ファイルが並び、未解決のレビュースレッドがあるファイルには件数付きのコメントバブルが付きます。開いた PR の下には、自分に関わるプルリクエストがグループに分かれて並びます——レビューリクエスト、作成、担当、そして参加中（コメントした、レビューした、またはメンションされた）。空のグループは隠され、ドラフトには・ドラフトと表示され、グループ名だけでは理由が分からないときは行がその理由を示します（・担当、 ・メンション）。各グループは直近更新順で 30 件まで読み込み、最後は 「さらに表示…」です。未読数は折りたたんだ見出しでも見え続けます。全体は設定でオフにでき、Markdown を変更する PR だけに絞ることもできます。

リポジトリをフォローすると、そこで開かれているものすべてが新しい順に見られます。セクション見出しの「リポジトリをフォロー…」は、すでに開いているリポジトリを提示するほか、owner/repo の直接入力も受け付けます。フォローしたリポジトリはそれ自身のグループになり、独自の未読ルールを持ちます——右クリックで 「すべて」、「自分のもののみ」、「なし」、そして「フォロー解除」を選べます。個々の PR や Issue の行は、それぞれの右クリックメニューからこのルールを上書きできます。

ひとつのリストにまとめたいなら？GitHub の作業をグループ化を関わりにすると、このセクションと Issue がひとつの GitHubセクションにまとまり、両方の種類が混ざったグループが行ごとにグリフ付きで並びます。

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

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

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

Issue

Issue についても考え方は同じです——作成、担当、 参加中、そしてフォロー中のリポジトリの Issue です。レビューを頼まれる文書はプルリクエストではなく Issue であることも少なくないからです。ひとつクリックすると文書として開きます——レンダリングされた本文、ラベル、リアクション付きのコメントタイムライン、そして末尾にコメント入力欄です。アプリを離れることなく、コメント、リアクション、そして自分のコメントの編集や削除ができます。開いている Issue はセクションの一番上に単独の行として陣取り、最近使った項目や ⌘K の「クイックオープン」にも入り、セッションとともに戻ってきます。

項目を取り除く

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

アイコン一覧

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

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