entity show

Gibt eine einzelne Entität formatiert aus — Metadaten, Repräsentationen, externe Verweise und Body. Reine Lese-Operation, kein Write, keine Index-Änderung.

Grundaufruf

apparat entity show V1StGXRa

Typische Ausgabe:

Entity V1StGXRa — person
  Title:     Maria Beispiel
  Created:   2026-04-19
  Updated:   2026-04-21T10:14:02+02:00
  Language:  de
  Tags:      wcag, barrierefreiheit
  File:      content/2026-04-19--maria-beispiel--V1StGXRa.md

Representations:
  audio/mpeg               ../assets/2026-04-19--interview-maria--Fg6hJk4l.mp3

Other frontmatter:
  residence:         Berlin

Outgoing relations:
  Maria Beispiel --[works_at]--> Tollwerk GmbH
  Maria Beispiel --[knows]--> Max Mustermann

Incoming relations:
  Konferenz Beispiel --[organized_by]--> Maria Beispiel

Body (first 15 of 42 lines, use --body for full):
  # Maria Beispiel

  Kennengelernt auf der Konferenz im März — arbeitet an Accessibility-Themen
  im Banking-Kontext. Lesenswerte Artikel:
  …

Die Sektionen werden nur gezeigt, wenn sie Inhalt haben — eine Entität ohne Repräsentationen zeigt keinen „Representations:"-Block, ohne externe Verweise keinen „External:"-Block, ohne nutzerdefinierte Felder keine „Other frontmatter:"-Sektion. Auch die zwei Beziehungs-Sektionen erscheinen nur, wenn die Entität Beziehungen in der jeweiligen Richtung hat.

Die Beziehungs-Sektionen kommen aus dem Vault-Index (graph rebuild baut ihn auf, graph watch hält ihn aktuell). Beziehungen, die im Frontmatter stehen, aber noch nicht indexiert wurden, erscheinen erst nach dem nächsten Index-Lauf. „Outgoing" listet die Beziehungen, die diese Entität auf andere richtet; „Incoming" listet die Beziehungen, die andere Entitäten auf diese richten — also die Backlinks.

Kompletter Body

Standardmäßig zeigt Apparat die ersten 15 Zeilen als Preview. Für den vollständigen Body:

apparat entity show V1StGXRa --body

Ist der Body kürzer als 15 Zeilen, gibt Apparat ihn ohne Preview-Hinweis komplett aus.

JSON-Ausgabe

Für Scripting:

apparat entity show V1StGXRa --json

Gibt ein einzelnes JSON-Objekt auf stdout aus:

{
  "vault": {
    "name": "recherche",
    "url": "https://apparat.example.com/vaults/recherche",
    "path": "/home/max/vaults/recherche"
  },
  "entity": {
    "id": "V1StGXRa",
    "file": "content/2026-04-19--maria-beispiel--V1StGXRa.md",
    "absolute_path": "/home/max/vaults/recherche/content/2026-04-19--maria-beispiel--V1StGXRa.md",
    "frontmatter": {
      "id": "V1StGXRa",
      "type": "person",
      "created": "2026-04-19",
      "language": "de",
      "title": "Maria Beispiel",
      "tags": ["wcag", "barrierefreiheit"],
      "representations": [...]
    },
    "parse_error": null,
    "body": "# Maria Beispiel\n\n...",
    "body_lines": 42,
    "relations": [
      {
        "triple": "Maria Beispiel --[works_at]--> Tollwerk GmbH",
        "source": { "nano_id": "V1StGXRa", "title": "Maria Beispiel", "type": "person" },
        "relation": "works_at",
        "target": { "nano_id": "Qw9pLm2n", "title": "Tollwerk GmbH", "type": "organization" },
        "properties": { "since": 2019, "role": "lead" }
      }
    ],
    "incoming_relations": [
      {
        "triple": "Konferenz Beispiel --[organized_by]--> Maria Beispiel",
        "source": { "nano_id": "Az3kLm9p", "title": "Konferenz Beispiel", "type": "event" },
        "relation": "organized_by",
        "target": { "nano_id": "V1StGXRa", "title": "Maria Beispiel", "type": "person" },
        "properties": null
      }
    ]
  }
}

Der --body-Flag hat im JSON-Modus keinen Effekt — JSON enthält immer den vollständigen Body. Die zwei Beziehungs-Arrays sind im JSON-Modus immer vorhanden, auch wenn leer.

Vault wählen

Wie üblich: ohne --vault nimmt Apparat die Auflösung (CWD → einziger registrierter Vault → interaktive Auswahl); mit --vault=… explizit.

apparat entity show V1StGXRa --vault=arbeit

Fehler

„Entity id "…" is not a valid NanoId" — das Positional-Argument muss eine 8-stellige NanoID aus [A-Za-z0-9] sein.
„No entity with id "…" in vault "…"" — zur angegebenen NanoID existiert keine reguläre Entität im Vault. Entweder falsch getippt, oder die Entität liegt im Trash (dann vault trash list).
„Failed to read entity file "…"" — die Datei ist im Index registriert, lässt sich aber nicht lesen (Rechte, defektes FS). Apparat bricht ab.