AnnexText – Handbuch

1. Überblick

AnnexText ist die Textverarbeitungs-App der AnnexCREATE-Suite. Es ist ein schlanker, absatzbasierter Editor für Textdokumente im eigenen Container-Format .axtext (SwiftUI, macOS 14+). Die App richtet sich an Freelancer, Selbständige und kleine Agenturen, die Protokolle, Anschreiben, Konzepte und Notizen schnell erfassen und als DOCX, ODT oder PDF weitergeben wollen.

Kernnutzen:

• Bewusst einfaches Schreiben ohne Ribbon-Überbau – Gliederung, Editor und Inspector in einem Fenster.
• Absatzstile statt freier Inline-Formatierung: sechs Stile, die pro Absatz gelten.
• Export in gängige Büroformate (DOCX, ODT, PDF) und identischer Druck-/PDF-Zeichenpfad.
• Saubere Verzahnung mit den anderen Annex-Apps über die Annex-Zwischenablage und die gemeinsame Asset-Bibliothek.
• Dokumentweites Suchen & Ersetzen sowie Kopf-/Fußzeilen mit Seitenzahlen.

AnnexText ist Teil der AnnexCREATE-Suite („Creative OS"): Alle Apps teilen Design-System, Dokument-Containerformat, lokale Datenhaltung (Offline-first) und die MCP-Automatisierung. Die modulare Integration sorgt dafür, dass du Texte dort weiterverwenden kannst, wo du sie brauchst – etwa in AnnexOffice oder AnnexPublish.

2. Installation & Aktivierung

AnnexText wird über AnnexHub bezogen und verwaltet:

• Download & Updates: AnnexHub ist die zentrale Anlaufstelle für Apps, Updates und Lizenzen.
• Lizenzaktivierung: Die Lizenz wird zentral über AnnexHub aktiviert (AnnexLicenseKit); eine Offline-Aktivierung ist möglich.
• Offline-Betrieb: AnnexText ist Offline-first. Die App läuft ohne Serververbindung; alle Dokumente bleiben lokal auf deinem Mac.

3. Grundworkflow

Der typische Ablauf vom Start bis zum fertigen Dokument:

1. Starten: AnnexText aus AnnexHub öffnen oder eine vorhandene .axtext-Datei öffnen (Ablage ▸ Öffnen…, ⌘O).
2. Dokument beginnen: Per Toolbar-Button „Absatz hinzufügen" einen neuen Absatz anlegen und direkt schreiben.
3. Titel vergeben: Den Dokumenttitel im Inspector rechts eintragen.
4. Strukturieren: Pro Absatz einen Stil wählen (Titel, Überschrift 1, Überschrift 2, Fließtext, Zitat, Aufzählung) – direkt im Editor oder im Inspector.
5. Navigieren: Über die Gliederung in der Sidebar Absätze selektieren und zu ihnen springen.
6. Papierausgabe vorbereiten (optional): Kopf-/Fußzeile und Seitenzahlen im Inspector aktivieren.
7. Sichern & weitergeben: Als .axtext speichern (⌘S) und bei Bedarf als DOCX, ODT oder PDF exportieren oder drucken (⌘P).

4. Kernfunktionen

4.1 Arbeitsplatz & Menüleiste

AnnexText nutzt das Drei-Spalten-Design der Suite: Gliederung und Asset-Bibliothek in der Sidebar links, Editor in der Mitte, Inspector rechts. Die Titlebar ist transparent, der App-Header (AppBrandedHeader) zeigt die Toolbar-Buttons, die Darstellung ist themefähig (hell/dunkel/system, persistiert über den ThemeManager).

Echte macOS-Menüeinträge (verdrahtet über WindowActions):

• Ablage ▸ Öffnen… – ⌘O
• Ablage ▸ Speichern – ⌘S
• Ablage ▸ Speichern unter… – ⌘⇧S
• Ablage ▸ Exportieren… – ohne Kürzel
• Ablage ▸ Drucken… – ⌘P
• Bearbeiten ▸ Suchen… – ⌘F
• Bearbeiten ▸ Suchen und Ersetzen… – ⌥⌘F
• Bearbeiten ▸ Weitersuchen – ⌘G
• Bearbeiten ▸ Rückwärts suchen – ⇧⌘G
• AnnexText ▸ Einstellungen… – ⌘,

Undo und die übrigen Bearbeiten-Befehle bleiben Systemstandard.

4.2 Schreiben: Absätze & Stile

Das Dokument ist eine Folge einzeln bearbeitbarer Absätze mit sechs Stilen (ParagraphStyle): Titel, Überschrift 1, Überschrift 2, Fließtext, Zitat, Aufzählung. Den Stil wählst du pro Absatz direkt im Editor oder im Inspector. Es gibt bewusst keine Inline-Formatierung (kein Fett/Kursiv innerhalb eines Absatzes) und keine Bilder, Tabellen oder Fußnoten – die Stile gelten pro Absatz.

4.3 Gliederung & Inspector

• Gliederung (Sidebar): ein Eintrag pro Absatz mit Stil-Icon und Textvorschau. Ein Klick selektiert den Absatz für Editor und Inspector.
• Inspector (rechts): Stil des ausgewählten Absatzes, Wort- und Zeichenzahl pro Absatz, bearbeitbarer Dokumenttitel sowie Dokument-Kennzahlen (Absätze, Wörter, Seiten). Hier löschst du auch Absätze (mindestens ein Absatz bleibt erhalten).

4.4 Suchen & Ersetzen

Die Suchleiste (TextFindBar) liegt über dem Editor und arbeitet dokumentweit über alle Absätze:

• Suchen – Bearbeiten ▸ Suchen… (⌘F): Mehrfachtreffer pro Absatz, Trefferanzeige („2 von 5" / „Keine Treffer").
• Suchen und Ersetzen – Bearbeiten ▸ Suchen und Ersetzen… (⌥⌘F): Ersetzen einzeln und „Alle ersetzen", Option Groß-/Kleinschreibung.
• Weitersuchen – ⌘G und Rückwärts suchen – ⇧⌘G: Treffernavigation vor/zurück mit Wrap-around; der Treffer-Absatz wird selektiert und angescrollt.

4.5 Kopf-/Fußzeilen & Seitenzahlen

Im Inspector-Abschnitt Kopf-/Fußzeilen legst du pro Dokument einen Kopf- und einen Fußzeilentext fest. Seitenzahlen sind zuschaltbar – im Format „Seite X" oder nur „X". Für Kopfzeile, Fußzeile und Seitenzahl gibt es je eine Position-Option (links/mitte/rechts); eine aktive Seitenzahl wird an den Fußzeilentext angehängt. Die Ausgabe erfolgt im gemeinsamen Druck-/PDF-Zeichenpfad (TextPrintLayout), gezeichnet in den Seitenrändern – die Seitenaufteilung bleibt unverändert. Ältere .axtext-Dateien ohne diese Felder laden mit Defaults (alles aus).

4.6 Dokumente verwalten & Autosave

AnnexText erstellt, öffnet und speichert .axtext-Dateien (Ablage ▸ …). Bei bekanntem Dateiort speichert ⌘S direkt, sonst erscheint „Speichern unter" (⌘⇧S). Der Autosave sichert bei aktivierter Einstellung (autosaveEnabled, konfigurierbares Intervall) und anstehenden Änderungen im 30-Sekunden-Takt still am bekannten Dateiort. Die App beendet sich beim Schließen des letzten Fensters.

4.7 Export & Druck

Über den Export-Dialog (Ablage ▸ Exportieren… oder Toolbar-Button „Exportieren") erzeugst du echte Dateien, keine Platzhalter:

• DOCX (DOCXExportService): echtes Office-Open-XML-ZIP mit Absatzstilen (Title, Heading 1/2, Quote, nummerierte Liste).
• ODT (ODTExportService): echtes OpenDocument-Text-ZIP inklusive styles.xml und korrekter mimetype-Datei.
• PDF (TextPDFExportService): rendert über denselben Zeichenpfad wie der Druck – PDF- und Druckausgabe sind identisch.

Drucken (Ablage ▸ Drucken…, ⌘P) nutzt ein DIN-A4-Seitenlayout mit Rändern und Absatzumbruch über Seiten hinweg, über die suite-weite AnnexPrintable-Schnittstelle (AnnexPrintSheet/AnnexPrintOperation). Die Seitenzahl wird im Inspector angezeigt. Hinweis: Kopf-/Fußzeilen werden in DOCX-/ODT-Exporten (feldbasierte Formate) derzeit noch nicht ausgegeben.

4.8 Asset-Integration & Annex-Zwischenablage

• Asset-Bibliothek (AssetLibraryView aus AnnexAssetKit) liegt in der Sidebar. Ziehst du ein Asset per Drag & Drop in den Editor, wird eine sichtbare Dateireferenz als Zitat-Absatz eingefügt (Inline-Bilder unterstützt das Dokumentmodell nicht).
• Annex-Zwischenablage (TextInteropService): „Gesamten Text kopieren" legt den Fließtext des Dokuments ab; „Aus Annex-Zwischenablage einfügen" hängt Text als neuen Absatz an. Es wird auch der Text-Fallback anderer Annex-Apps angenommen.

5. Formate & Interoperabilität

• Eigenformat .axtext: Annex-Container (AnnexDocument aus AnnexCoreKit), der Titel, Absätze und Kopf-/Fußzeilen-Einstellungen als JSON-Snapshot (text.json) enthält. Öffnen und Speichern sind vollständig implementiert; Snapshots vor v0.2 (ohne Kopf-/Fußzeilen-Felder) laden mit Defaults.
• Export: DOCX (Office Open XML), ODT (OpenDocument Text), PDF – jeweils echte Dateien.
• Import: ausschließlich .axtext. Ein Import fremder Formate (z. B. DOCX/ODT) ist nicht implementiert.
• Suite-Interop: Textaustausch über die Annex-Zwischenablage (AnnexInteropKit, PasteboardItem.text mit Text-Fallback); Asset-Referenzen aus AnnexAssetKit per Drag & Drop.
• Zentrale Suche (AnnexHub): Beim Speichern wird das Dokument best-effort in den geteilten Versions-Index (SharedVersionIndexStore) geschrieben – mit deterministischer Dokument-ID aus dem Dateipfad – und taucht dadurch in der AnnexHub-Suche auf.
• iCloud/Sync: nicht verdrahtet. Alle Dateien sind rein lokal.

6. MCP-Bedienung

Der MCP-Host läuft in AnnexHub und spricht JSON-RPC 2.0 via STDIO; er wird über AnnexHub gestartet. Damit sind die Aktionen von AnnexText für KI-Agenten und Automatisierung erreichbar.

Suite-weite Tools (für alle Apps): list_apps, open_app, open_document, get_active_document, get_license_status, search_assets.

App-spezifische Tools für AnnexText (im MCPToolRegistry registriert):

• text.create_document – erstellt ein echtes .axtext-Dokument als Datei; ohne path kollisionsfrei unter ~/Documents/AnnexText/<Titel>.axtext, die Antwort enthält den tatsächlichen Pfad.
• text.add_paragraph – fügt einem bestehenden .axtext einen Absatz (Text, Stil) hinzu und speichert die Datei (echte Dateiänderung).
• text.open_document – öffnet ein .axtext-Dokument in AnnexText.

Skills (suite-weit): suite.discover, brandkit.apply.

Über diese Schnittstelle sind Dokument-Erstellung, Absatz-Bearbeitung und Öffnen vollständig automatisierbar.

7. Diagnostik & Privatsphäre

AnnexText protokolliert Fehler und Aktionen lokal über AnnexDiagnosticsKit in rotierende JSON-Log-Dateien unter ~/Library/Logs/AnnexCREATE/AnnexText/, gespiegelt nach os_log (Subsystem com.annexcreative.annextext), mit PII-Filter. Die Diagnostik ist in der Entwicklungsphase per Default aktiv und in den Einstellungen (Datenschutz) abschaltbar; es erfolgt keine Übertragung. Telemetrie ist im App-Init verdrahtet (TelemetryClient.shared.configure) und läuft ausschließlich per Opt-in (Default aus). Alle Daten – Dokumente, Logs, Einstellungen – bleiben auf deinem Mac.

8. FAQ

Braucht AnnexText eine Internetverbindung? Nein. Die App ist Offline-first und läuft ohne Serververbindung. Lizenzaktivierung ist auch offline möglich.

Kann ich Word- oder OpenOffice-Dateien öffnen? Der Import fremder Formate (DOCX/ODT) ist noch nicht implementiert. Du kannst aber als DOCX, ODT und PDF exportieren und Text über die Zwischenablage einfügen.

Wo finde ich meine Log-Dateien? Unter ~/Library/Logs/AnnexCREATE/AnnexText/. Die Diagnostik ist in der Entwicklungsphase standardmäßig aktiv und in den Einstellungen abschaltbar.

Warum gibt es kein Fett/Kursiv im Text? AnnexText ist bewusst absatzbasiert: Stile gelten pro Absatz, nicht innerhalb eines Absatzes. Inline-Formatierung, Bilder, Tabellen und Fußnoten sind nicht Teil des Dokumentmodells.

Wie funktioniert der Autosave? Bei aktivierter Einstellung und einem bekannten Dateiort sichert AnnexText anstehende Änderungen alle 30 Sekunden still. Das Intervall ist konfigurierbar.

Werden meine Daten irgendwohin übertragen? Nein. Diagnostik und Telemetrie sind PII-gefiltert; Diagnostik bleibt lokal, Telemetrie nur bei Opt-in. Es gibt kein Cloud-Sync – alle Dateien bleiben lokal.

In welchen Sprachen ist die Oberfläche verfügbar? Deutsch, Englisch, Spanisch, Französisch und Italienisch über die suite-weiten L10n-Kataloge.