Notezbeta
Zurück zum Blog

Notizen direkt aus dem Terminal festhalten

terminalDenis Povarov

Wenn du den Tag im Terminal verbringst, ist der Wechsel in eine grafische Notizen-App ein Kontextwechsel, den du doppelt bezahlst: einmal für den Weg dorthin und noch einmal, wenn du zurückkommst und dich wieder konzentrieren musst. Notizen direkt auf der Kommandozeile sparen beides. Hier geht es um die wichtigsten Ansätze, von einfachen Textdateien ohne jede Abhängigkeit bis zu eigens dafür gebauten CLI-Tools, und darum, wann welcher sinnvoll ist.

Warum das Terminal ein guter Ort für Notizen ist

Drei Eigenschaften machen die Shell zu einem besonders guten Ort zum Festhalten:

  • Du bist schon da. Mitten im Debugging, im Deploy, im Code-Review – der Prompt hat den Fokus und wartet.

  • Ausgaben sind Text. Fehlermeldungen, fehlgeschlagene Tests und Befehlsausgaben leitest du per Pipe direkt in eine Notiz, ohne Screenshot und ohne Abtippen.

  • Es funktioniert überall. Über SSH, in tmux, auf einer CI-Maschine – wo eine Shell läuft, läuft auch deine Methode zum Festhalten.

Notizen im Terminal scheitern meist am anderen Ende: beim Wiederfinden. Textdateien wachsen, und die richtige Zeile drei Monate später zu finden, ist der schwierige Teil. Behalte diesen Zielkonflikt im Kopf, wenn du einen Ansatz wählst.

Ansatz 1: eine einfache Datei, an die du nur anhängst

Das einfachste System, das funktioniert:

Bash 
echo "$(date +%F) - use SIGTERM not SIGKILL in the entrypoint" >> ~/notes.md

Pack das in eine Shell-Funktion, und es wird zur Gewohnheit, die zwei Tastendrücke kostet:

Bash 
note() { echo "$(date +%F) $*" >> ~/notes.md; }

Zum Wiederfinden reicht grep -i keyword ~/notes.md. Das kostet nichts, wird mit allem synchronisiert, was dein Home-Verzeichnis synchronisiert, und geht nie kaputt.

Die Grenzen zeigen sich mit der Menge: Eine flache Datei hat keine Struktur, grep findet nur exakte Wörter, und auf einen zweiten Rechner folgt dir nichts, solange du die Synchronisierung nicht selbst einrichtest.

Ansatz 2: Notizen im Editor, aus der Shell gestartet

vim ~/notes/$(date +%F).md oder ein kleines Skript, das die heutige Tagesnotiz öffnet, gibt dir einen richtigen Editor und eine Datei pro Tag. Tools dieser Art (Skripte für Tagesnotizen, nb, Journal-CLIs) bringen gerade genug Struktur mit – datierte Dateien, manchmal Tags – und bleiben dabei lokal und skriptbar.

Das passt gut, wenn Notizen länger als eine Zeile sind. Der Preis: Einen Editor zu öffnen ist kein Festhalten in zwei Sekunden mehr, sondern eine kleine Aufgabe für sich, und über SSH fehlt womöglich deine Editor-Konfiguration.

Ansatz 3: eine eigene CLI zum Festhalten, mit synchronisiertem Tresor dahinter

Der dritte Ansatz trennt das Festhalten vom Speichern: eine kleine CLI, deren einzige Aufgabe es ist, Text aus deiner Shell zu nehmen und in ein Notizsystem zu legen, das sich an anderer Stelle um Suche, Synchronisierung und Ordnung kümmert.

So funktioniert die Notez CLI. Sie ist ein 3-MB-Binary für macOS, Linux und Windows; nach einem einmaligen notez login sieht das Festhalten so aus:

Bash 
notez "the flaky test is timezone-dependent — freeze the clock"
echo "worth keeping" | notez
notez --title "Postmortem notes" "timeline starts 14:02 UTC"

Die Notizen landen in einem Workspace, den du auch über eine Web-App erreichst, also hängt das Wiederfinden nicht an grep: Die Suche arbeitet nach Bedeutung (die Suche nach „flaky tests“ findet die Notiz über die Zeitzone), und was du festgehalten hast, kannst du später taggen, mit anderen Notizen verlinken oder in einem vollwertigen Editor ausbauen. URLs erkennt die CLI automatisch und speichert sie als Lesezeichen, und dank der Ausgabe mit --json lässt sie sich in Skripten und Git-Hooks verwenden.

Der Zielkonflikt ist das Spiegelbild der einfachen Datei: Du gewinnst Suche, Synchronisierung und Struktur, dafür liegen deine Notizen in einem Dienst statt in einer einzelnen lokalen Datei. Wenn dir das wichtig ist, prüf den Ausstieg. Notez zum Beispiel exportiert einen ganzen Workspace als .zip mit Markdown-Dateien und ihren Anhängen, und an dieser Messlatte kannst du jedes Tool messen.

Gewohnheiten, die in jedem System funktionieren

Welchen Ansatz du auch wählst, ein paar Gewohnheiten sorgen dafür, dass Notizen aus dem Terminal später wirklich nützen:

Pipen statt abtippen

Das stärkste Argument fürs Festhalten im Terminal ist, dass das Material schon als Text vor dir steht:

Bash 
./run-tests.sh 2>&1 | tail -20 | notez --title "auth test failure"

Eine Notiz mit der echten Fehlerausgabe ist so viel wert wie zehn, die sie nacherzählen.

Halte Lösungen fest, nicht nur Probleme

Die wertvollste Notiz im Tresor eines Entwicklers lautet „das hat es behoben“. Wenn etwas endlich funktioniert, schreib die Ursache in einer Zeile auf. Dein späteres Ich sucht nach der Fehlermeldung und findet die Antwort.

Zeitstempel automatisch, Titel sparsam

Lass das Tool festhalten, wann eine Notiz entstanden ist. Titel sind bei schnellen Notizen optional: Eine Notiz, die zwei Sekunden gekostet hat, ist auch ohne Titel ein Gewinn, und die Suche nach Bedeutung braucht keine Titel, um sie zu finden.

Ein einziger Eingang

Schick alle schnellen Notizen an einen Ort und sortiere später (oder nie). Sobald du dich beim Festhalten für ein Ziel entscheiden musst, ist der Aufwand zurück, den du loswerden wolltest.

Welcher Ansatz passt

  • Einfache Datei: Du willst keine Abhängigkeiten, und deine Notizen sind kurzlebiges Arbeitsgedächtnis.

  • Editor + datierte Dateien: Deine Notizen sind länger, und du arbeitest an einem einzigen Rechner.

  • CLI zum Festhalten + synchronisierter Tresor: Du hältst oft fest, von mehreren Rechnern aus, und das Wiederfinden ist dir so wichtig wie das Festhalten.

Die Ansätze lassen sich auch kombinieren. Viele führen eine Notizdatei für Kurzlebiges und einen synchronisierten Tresor für alles, was sie wiederfinden wollen. Die einzige echte Regel: Mach das Festhalten so mühelos, dass du es wirklich tust. Ein Notizsystem, das du täglich nutzt, schlägt ein ausgefeiltes, das du nicht nutzt.

Weiterlesen