Notezbeta
Zurück zum Blog

Erste Schritte mit der Notez CLI

terminalDenis Povarov

Die Notez CLI ist ein natives Binary mit 3 MB, das Notizen aus deiner Shell erfasst. Keine Node-Runtime, kein Daemon, keine Konfigurationsdatei, die du von Hand schreiben musst: Du installierst sie, autorisierst das Terminal einmal, und ab dann landet jeder Gedanke mit notez "dein Gedanke" in deinem Workspace. Sie läuft auf macOS, Linux und Windows.

Diese Anleitung führt durch die Installation, die Ersteinrichtung und die paar Flags, die du kennen solltest.

Installation

Unter macOS oder Linux:

sh 
curl -fsSL https://notez.dev/install.sh | sh

Das Skript lädt das neueste Binary für deine Plattform herunter, prüft die SHA256-Prüfsumme und legt notez in /usr/local/bin ab (oder in ~/.local/bin, falls dort keine Schreibrechte bestehen).

Unter Windows, in PowerShell:

powershell 
iwr -useb https://notez.dev/install.ps1 | iex

Das installiert die CLI nach %LOCALAPPDATA%\Programs\notez und nimmt den Ordner in deinen Benutzer-PATH auf.

Wenn du lieber kein Skript in deine Shell pipen willst – ein vernünftiger Reflex –, liegen die Binaries direkt unter https://notez.dev/downloads/cli/ bereit, für macOS (arm64 und x64), Linux (x64 und arm64) und Windows, jeweils mit einer .sha256-Datei daneben für die Prüfung von Hand. Entpacke das Archiv und leg notez an eine beliebige Stelle in deinem $PATH.

Ein Hinweis zu macOS: Lädst du das Tar-Archiv über den Browser statt mit curl herunter, stellt Gatekeeper es unter Quarantäne. Entferne das Attribut einmalig mit xattr -d com.apple.quarantine /path/to/notez.

Das Terminal autorisieren

Bash 
notez login

Das öffnet im Browser notez.dev/cli-auth. Dort wählst du einen Workspace, dessen Eigentümer du bist, und gibst das Terminal frei; nur der Eigentümer eines Workspace kann die CLI dafür einrichten. Notez erzeugt einen langlebigen API-Schlüssel, der nur für diesen einen Workspace gilt und nur Notizen erstellen und Dateien hochladen darf, und die CLI speichert ihn lokal:

  • macOS: ~/Library/Application Support/notez/config.toml

  • Linux: ~/.config/notez/config.toml

  • Windows: %APPDATA%\notez\config.toml

Unter Einstellungen → Integrationen → Notez CLI widerrufst du den Schlüssel jederzeit, etwa wenn ein Laptop verloren geht oder ein gemeinsam genutzter Rechner keinen Zugriff mehr haben soll. notez logout löscht den Schlüssel lokal.

Notizen erfassen

Meist reicht ein einziger Befehl:

Bash 
notez "retry storm happens when the circuit breaker resets too early"

Der Text wird zu einer Notiz in deinem Workspace und ist sofort durchsuchbar. Ein paar Varianten decken den Rest des Alltags ab:

Bash 
# Pipe output into a note
grep -c ERROR app.log | notez

# Give the note an explicit title (otherwise the text is used)
notez --title "Incident 2026-08-30" "db failover took 40s, alarms fired late"

# Capture a URL — auto-detected and stored as a bookmark
notez "https://docs.anthropic.com/quickstart"

# Upload a file — a path that exists is detected and uploaded
notez ./architecture-diagram.png

Die Variante mit Pipe verdient besondere Erwähnung. Alles, was deine Shell erzeugt – die Ausgabe eines fehlschlagenden Tests, ein Stacktrace, die Kombination von Flags, die endlich funktioniert hat –, hältst du in dem Moment fest, in dem es auf dem Bildschirm steht, ohne Text zu markieren oder das Fenster zu wechseln.

Skripte mit --json

notez --json "..." gibt die erstellte Notiz als JSON aus, und so lässt sich die CLI mit anderen Tools kombinieren. Zwei praktische Muster:

Bash 
# Capture and keep the note id for later reference
NOTE_ID=$(notez --json "deploy checklist for v2.3" | jq -r .id)

# A git hook that logs every release
notez "released $(git describe --tags) to production"

Weil sie ein einzelnes, schnelles Binary ist, passt die CLI auch dorthin, wo schwerere Tools stören: in CI-Jobs, auf entfernte Server über SSH, in ein tmux-Pane, das neben deinem Editor offen bleibt.

Wo die Notizen landen

Was die CLI erfasst, landet im selben Tresor wie alles, was auf anderen Wegen in Notez ankommt: über das Web-Dashboard, über die Adressleiste mit notez.dev/dein Gedanke und über KI-Tools, die per MCP verbunden sind. In der Web-App durchsuchst du die erfassten Notizen, vergibst Tags, verlinkst sie mit anderen Notizen oder baust eine rohe Notiz im vollen Editor zu einem strukturierten Dokument aus.

Die Suche in Notez arbeitet nach Bedeutung, nicht nur nach Stichwörtern. Eine knappe Notiz wie notez "Cursor-Pagination schlägt Offset bei großen Tabellen" findest du später mit der Suche nach „Performance der Pagination“, obwohl du sie nie getaggt oder abgelegt hast.

Ein Ablauf, der bleibt

Die CLI zahlt sich aus, wenn du die Messlatte dafür senkst, was eine Notiz verdient. Braucht die Notizen-App zwanzig Sekunden, bis sie offen ist, schaffen es nur wichtige Gedanken über die Latte, und die meisten kleinen – der Workaround, das Flag, die halbfertige Idee – gehen verloren. Bei zwei Sekunden schafft es alles.

Ein paar Gewohnheiten zum Abschauen:

  • Halte den Fix fest, nicht nur den Bug. Sobald etwas endlich funktioniert, schick den Grund mit notez "..." ab. Dein späteres Ich sucht danach, wenn derselbe Fehler wieder auftaucht.

  • Protokolliere Entscheidungen, wenn sie fallen. Eine Zeile dazu, warum du Ansatz A statt B gewählt hast, ist besser, als sie später im Review eines Design-Dokuments zu rekonstruieren.

  • Pipen statt einfügen. Wenn es schon in deinem Terminal steht, ist | notez schneller und genauer als Kopieren und Einfügen in eine GUI.

Fehlerbehebung

Meldet notez login, dass die CLI auf deinem Rechner nicht erreichbar war, ist beim Autorisieren vermutlich die Zeit abgelaufen – führ notez login noch einmal aus. Funktioniert ein Schlüssel nicht mehr, sieh unter Einstellungen → Integrationen → Notez CLI nach: Ein dort widerrufenes Terminal ist sofort gesperrt, und ein erneutes notez login auf diesem Rechner stellt einen neuen Schlüssel aus.

Das ist das ganze Tool. notez --help listet alles auf, notez update installiert die neueste Version an Ort und Stelle, aber ehrlich zusammengefasst: ein Befehl, dein Gedanke, fertig.

Weiterlesen