entity list

Listet alle Entitäten eines Vaults als Tabelle. Mit optionalen Filtern nach Typ, Tag oder Volltext-Substring.

Basisaufruf

apparat entity list

Output:

Vault "recherche" — 12 entities
+----------------------------+------------+----------+---------------------+--------------------------------------+
| Title                      | Type       | Id       | Tags                | File                                 |
+----------------------------+------------+----------+---------------------+--------------------------------------+
| Anna Schmidt               | person     | Fg6hJk4l | designerin          | 2025-08-09--anna-schmidt--Fg6hJk4l.md|
| Apparat-Projekt            | projekt    | Xp2wRq7s | wissen, knowledge   | 2026-04-01--apparat-projekt--Xp2wRq7s.md |
| Maria Beispiel             | person     | V1StGXRa | kollegin, wcag      | 2026-04-21--maria-beispiel--V1StGXRa.md |
| WCAG 2.2                   | konzept    | Zn8mPq1r | wcag, barrierefreiheit | 2024-10-05--wcag-2-2--Zn8mPq1r.md |
...
+----------------------------+------------+----------+---------------------+--------------------------------------+

Sortiert nach Titel, case-insensitiv. Spalten:

Title — die Anzeigeform, in dieser Reihenfolge aus Frontmatter-title, erster H1 im Body, humanisiertem Slug des Dateinamens oder (untitled).
Type — der oder die Typen (bei mehreren kommagetrennt).
Id — die NanoID.
Tags — die Tags kommagetrennt, oder —, wenn keine gesetzt sind.
File — der Dateiname (ohne Pfad, der Vault ist im Kopf angezeigt).

Sortierung

Default ist Sortierung nach Titel (case-insensitiv aufsteigend). Mit --sort lässt sich auf das Bearbeitungs- oder Erstellungs-Datum umschalten, mit --desc umkehren:

apparat entity list --sort=updated           # zuletzt bearbeitet zuerst (aufsteigend)
apparat entity list --sort=updated --desc    # zuletzt bearbeitet zuletzt – aktuell oben
apparat entity list --sort=created           # älteste Notizen zuerst

Bei --sort=updated und --sort=created blendet Apparat die jeweils relevante Datums-Spalte zwischen Tags und File ein:

Vault "recherche" — 12 entities
+----------------------------+------------+----------+---------------------+------------+--------------------------------------+
| Title                      | Type       | Id       | Tags                | Updated    | File                                 |
+----------------------------+------------+----------+---------------------+------------+--------------------------------------+
| Maria Beispiel             | person     | V1StGXRa | kollegin, wcag      | 2026-04-21 | 2026-04-21--maria-beispiel--V1StGXRa.md |
| Apparat-Projekt            | projekt    | Xp2wRq7s | wissen, knowledge   | 2026-04-12 | 2026-04-01--apparat-projekt--Xp2wRq7s.md |
| WCAG 2.2                   | konzept    | Zn8mPq1r | wcag, barrierefreiheit | 2024-10-05 | 2024-10-05--wcag-2-2--Zn8mPq1r.md |
+----------------------------+------------+----------+---------------------+------------+--------------------------------------+

Bei --sort=updated nutzt Apparat das updated-Feld; fehlt es, fällt es auf created zurück. Entitäten ohne beide Werte landen am Ende der Liste, auch unter --desc.

Recency-Filter

--since reduziert die Liste auf Notizen, die ab einem bestimmten Zeitpunkt bearbeitet wurden (updated-Wert; mit Fallback auf created):

apparat entity list --since=7d                   # letzte 7 Tage
apparat entity list --since=24h --sort=updated   # letzte 24 Stunden, nach Bearbeitung sortiert
apparat entity list --since=2w                   # letzte 2 Wochen
apparat entity list --since=2026-04-01           # alles seit dem 1. April 2026
apparat entity list --since=2026-04-01T10:00:00  # ISO-DateTime mit Uhrzeit

Erlaubte Dauer-Suffixe: s (Sekunden), m (Minuten), h (Stunden), d (Tage), w (Wochen). Absolute Werte als ISO-Datum oder ISO-DateTime. Andere Eingaben werden mit einer klaren Fehlermeldung abgelehnt.

Filter: nach Typ

apparat entity list --type=person
apparat entity list --type=project

Passt auch auf Listen: eine Entität mit type: [document, concept] erscheint bei --type=concept genauso wie bei --type=document.

Filter: nach Tag

apparat entity list --tag=wcag

Der Vergleich ist case-insensitiv auf der gesamten Tag-Zeichenkette — --tag=wcag findet auch Entitäten, deren Tag exakt WCAG heißt.

Volltext-Suche

apparat entity list --search=barrierefreiheit

Sucht case-insensitiv per Substring in:

dem Titel (nach Anwenden der Fallback-Logik),
der Tag-Liste,
dem Fließtext der Markdown-Datei.

Siehe auch das bequemere entity search, das dasselbe macht, aber mit dem Suchbegriff als positionales Argument.

Filter kombinieren

Alle Filter sind UND-verknüpft:

apparat entity list --type=person --tag=wcag
apparat entity list --type=article --search=2025
apparat entity list --type=person --tag=kollegin --search=berlin

Je mehr Filter, desto schmaler das Ergebnis.

Scan-Diagnose

Wenn im content/-Verzeichnis Dateien liegen, die Apparat nicht regulär lesen kann (kein NanoID-Suffix im Dateinamen, kaputtes Frontmatter, nicht-lesbare Datei), erscheinen diese unter der Tabelle als Diagnose-Hinweise:

Vault "recherche" — 5 entities
+----+------+----+------+------+
...
+----+------+----+------+------+

1 scan diagnostic:
  - File "kaputt.md" does not match the entity filename pattern.

Die betreffenden Dateien sind nicht in der Tabelle enthalten — sie sind für Apparat unsichtbar. vault irregular zeigt sie als eigene Liste; entity import überführt sie in den regulären Bestand.

Leerer Vault oder keine Treffer

Wenn der Filter nichts zutage fördert oder der Vault ganz leer ist:

No entities match the given filters in vault "recherche".

Das ist ein Erfolg, kein Fehler — der Exit-Code bleibt 0.

Vault wählen

Identisch zu entity new: mit --vault explizit angeben oder automatisch lokalisieren lassen (aktuelles Verzeichnis → einziger registrierter Vault → interaktive Auswahl).