docs

Die Seitenleiste

Bereiche, geordnet danach, was Dinge bedeuten, nicht woher sie kommen: was du offen hast (Geöffnete Dateien), die Orte, die du behältst (Angeheftet), die Ordner und Repos, die du durchstöberst (Orte), die Pull Requests und Issues, die dich betreffen, und wo du gewesen bist (Zuletzt benutzt).

Geöffnete Dateien

Das Arbeitsset: jedes Dokument, das du ausdrücklich geöffnet hast — aus dem Finder, per Drag & Drop, mit ⌘O, über die Kommandozeile oder indem du eine Datei aus einem Ort behalten hast. Flach, per Ziehen umsortierbar, jede Zeile mit dem Hover-✕ entfernbar (oder ⌫ auf der ausgewählten Zeile). Rechtsklick auf die Bereichsüberschrift für Alle schließen.

Vorschauen

Ein Einzelklick auf eine Datei in einem Ort rendert sie sofort — und sie erscheint in „Geöffnete Dateien“ als Vorschau: ein kursiver Eintrag, immer zuletzt im Bereich. Klick eine andere Datei und der Vorschau-Eintrag wird ersetzt — Stöbern durch einen großen Baum stapelt also nie Zeilen auf. Es ist dieselbe Idee wie die Vorschau-Tabs in VS Code oder Xcodes temporärer Editor, mit derselben Kursivschrift.

Eine Vorschau wird zu einem normalen, festen Eintrag, sobald du ihr mehr Verbindlichkeit zeigst als bloßes Lesen:

• Doppelklick auf die Datei im Baum — oder auf den kursiven Eintrag selbst
• Anfangen zu bearbeiten — der Bearbeitungsmodus oder das Speichern einer Blockänderung pinnt sie fest
• Geöffnet lassen im Rechtsklick-Menü

Lese-Interaktionen — Blame, Zeilenhistorie, ein Bild oder Diagramm inspizieren — befördern eine Vorschau absichtlich nie. Wenn du lieber jeden Klick Dateien voll öffnen lässt, stell Klick auf Dateien in „Orte“ in den Einstellungen um.

Remote-Repos previewen genauso, am selben Ort. Beim Stöbern durch den Baum eines GitHub-Repos, oder beim Folgen von Links in einem Remote-Dokument, landet derselbe eine kursive Eintrag in „Geöffnete Dateien“ — mit Buch-Icon und einer owner/repo @ ref-Zweitzeile, weil die Datei nicht auf deinem Mac liegt. Es gibt immer nur eine Vorschau pro Fenster, lokal oder remote: Etwas anderes zu previewen ersetzt, was du davor angesehen hast. Ein Remote-Doc zu behalten (Doppelklick oder „Geöffnet lassen“) heftet es bei seinem Repo ab — es wandert in die feste Liste des Repos unter „Orte“. ⌘K öffnet direkt fest, denn eine URL einzufügen ist ausdrückliche Absicht.

Jede Zeile unter „Geöffnete Dateien“, die in einem offenen Ort liegt, bekommt Im Ort zeigen ins Rechtsklick-Menü — der Sprung zurück von „was ich lese“ zu „wo es wohnt“.

Angeheftet

Die Ordner und Dateien, zu denen du immer wieder zurückkehrst, über „Orte“ — so wie der Finder seine Favoriten über allem anderen hält. Rechtsklick auf einen Ordner oder eine Datei in einem beliebigen Baum und wähl Anheften…: Ein Ordner wird zu einer eigenen Wurzel mit eigenem Baum, eine Datei wird zu einer Lesezeichen-Zeile, die per Klick previewt, und der neue Eintrag landet am Ende des Bereichs, schon im Umbenennen-Modus. Eine „Orte“-Wurzel bekommt Anheften (sie wandert hierher), eine angeheftete Wurzel bekommt Lösen (sie wandert ans Ende von „Orte“ und behält ihren Namen).

Umbenennen funktioniert wie im Finder: wähl Umbenennen… oder drück Return auf der ausgewählten Zeile, tipp, und Return, ein Klick anderswo oder das Weitergehen übernimmt; Escape bricht ab; ein leer gelassenes Feld geht zurück zum echten Namen. Ein umbenannter Eintrag zeigt seinen wahren Pfad in kleiner Schrift unter dem Namen, genau wie jedes Paar Wurzeln, das sich einen Namen teilt — damit sehen zwei Ordner namens docs nie gleich aus. Angeheftete Einträge sind eine Präferenz, kein Teil der Sitzung: Sie kommen bei jedem Start zurück, egal was Vorherige Sitzung wieder öffnen sagt.

Orte

Durchstöberbare Wurzeln, wo immer sie liegen. Zwei Arten teilen sich den Bereich, unterschieden per Icon:

Ein lokaler Ordner, der ein Git-Checkout ist, bekommt einen Branch-Chip (Branch-Glyphe + Name); liegt sein Remote auf GitHub, kommt eine kleine Geschlossenes-Buch-Marke dazu — Hover zeigt, welches Repo. Ein Klick auf den Branch-Chip öffnet das Branches-und-Worktrees-Menü:

• Worktrees — jeder Worktree des Repos, mit Häkchen auf dem, der diese Zeile ist; wähl einen anderen, um ihn als eigenen Ort zu öffnen. Worktrees werden von PullMark nie ausgecheckt oder gewechselt — es öffnet den Ordner, der schon da ist.
• Branch von GitHub anzeigen — lies die Dateien eines anderen Branches remote, ohne deinen Checkout anzufassen. Ein Branch, der schon einen lokalen Worktree hat, springt stattdessen zum Worktree — lokal schlägt remote.
• Auf GitHub öffnen — das Repo (auf diesem Branch) in deinem Browser.

Auf einem Remote-Repo (Buch-Icon) listet derselbe Chip Branches: Wechseln zu pinnt die Session auf einen anderen Branch um, und mit gehaltenem ⌥ gibt es Branch separat öffnen fürs Lesen nebeneinander. Repo-Dateien durchstöbern… lädt den ganzen Markdown-Baum des Repos. Die behaltenen Docs des Repos sitzen über dem Baum, damit sie in einem großen Repo nie untergehen; ein behaltenes Doc, das im Baum sichtbar ist, wird einfach dort dargestellt. (Ein Doc, das du nur previewst, erscheint unter Geöffnete Dateien, nicht hier.)

Ein Ordner, dessen Pfad nicht mehr auflöst (ein ausgeworfenes Volume, ein gelöschter Worktree), wird mit Fragezeichen-Badge gedimmt, statt zu verschwinden — er erwacht von selbst wieder, wenn der Pfad zurückkommt.

Pull Requests

Jeder geöffnete PR ist eine Gruppe: die Übersichtszeile (Status-Icon + Zahl geänderter Markdown-Dateien), dann seine geänderten Markdown-Dateien — eine Sprechblase mit Zahl markiert Dateien mit unaufgelösten Review-Threads. Unter deinen geöffneten PRs kommen die Pull Requests, die dich betreffen, in Gruppen: Review-Anfragen, Erstellt, Zugewiesen und Beteiligt (du hast kommentiert, reviewt oder wurdest erwähnt). Leere Gruppen bleiben verborgen, Entwürfe zeigen · Entwurf, und eine Zeile nennt den Grund, warum sie da ist (· zugewiesen, · erwähnt), wenn die Gruppe allein es nicht sagt. Jede Gruppe lädt die 30 zuletzt aktualisierten und endet mit Mehr anzeigen…. Ungelesen-Zahlen bleiben an eingeklappten Kopfzeilen sichtbar; das Ganze ist optional in den Einstellungen und filterbar auf PRs, die Markdown anfassen.

Einem Repository folgen, um alles zu sehen, was darin offen ist, neueste zuerst: Repository folgen… in der Bereichsüberschrift bietet die Repositorys an, die du schon offen hast, oder nimmt eingetipptes owner/repo entgegen. Ein gefolgtes Repository ist seine eigene Gruppe mit eigener Ungelesen-Regel — Rechtsklick darauf für Alles, Nur meine oder Ohne, und für Nicht mehr folgen. Jede einzelne PR- oder Issue-Zeile kann diese Regel über ihr eigenes Rechtsklick-Menü überschreiben.

Lieber eine Liste? GitHub-Arbeit gruppieren nach Beteiligung führt diesen Bereich und Issues zu einem einzigen GitHub-Bereich zusammen, dessen Gruppen beide Arten mischen, mit einer eigenen Glyphe pro Zeile.

Status-Icons auf PR-Zeilen:

Datei-Marker innerhalb eines PRs: +-Kreis (grün) für hinzugefügt, −-Kreis (rot) für entfernt, →-Kreis für umbenannt, Stift-Kreis für geändert.

Issues

Dieselbe Idee für Issues — Erstellt, Zugewiesen, Beteiligt und die Issues gefolgter Repositorys — weil das Dokument, das du reviewen sollst, oft ein Issue ist, kein Pull Request. Klick eines an und es öffnet sich als Dokument: der gerenderte Text, seine Labels, die Kommentar-Timeline mit Reaktionen und am Ende ein Kommentarfeld. Kommentiere, reagiere und bearbeite oder lösche eigene Kommentare, ohne die App zu verlassen. Ein offenes Issue sitzt als einzelne Zeile oben im Bereich, landet unter „Zuletzt benutzt“ und in ⌘K Schnell öffnen, und kommt mit der Sitzung zurück.

Zuletzt benutzt

Kürzlich geöffnete Dateien, Ordner und Pull Requests, die oben nicht schon sichtbar sind. PR-Einträge tragen ihr Live-Status-Icon; ein Eintrag, dessen Datei verschwunden ist, wird gedimmt (Uhr-Badge), statt zu verschwinden, und erwacht wieder, wenn der Pfad zurückkommt — gebaut für Branch-Wechsel und ausgeworfene Volumes. Rechtsklick auf die Überschrift für „Zuletzt benutzt“ leeren.

Dinge entfernen

Fahr über eine beliebige Zeile der obersten Ebene für das ✕ — es entfernt die Zeile aus der Seitenleiste, nie etwas von der Platte oder von GitHub. ⌫ auf einer ausgewählten Zeile tut dasselbe. Dateien im Baum eines Ortes haben kein ✕: Sie sind sein Inhalt, keine Seitenleisten-Einträge.

Icon-Glossar

Die Branch-Glyphe erscheint nur an echten Git-Refs (als Chip, nie als Ordner-Icon) — ein Ordner ist ein Ordner, ein Repo ist ein Buch, ein Branch ist ein Branch.