AnnexHub – Handbuch

1. Überblick

AnnexHub ist die zentrale Steuerungs- und Store-App der Suite AnnexCREATE – die erste Anlaufstelle für alle Kundinnen und Kunden. Sie verwaltet Apps, Lizenzen, Teams, Assets und Brandkits, installiert und aktualisiert die übrigen Apps der Suite und beherbergt den MCP-Host für die Automatisierung.

Kernnutzen auf einen Blick:

• Ein Ort für die ganze Suite: alle zehn Apps installieren, aktualisieren und öffnen – inklusive Update-Check mit Changelog.
• Lizenzverwaltung online und offline: Lizenzschlüssel einlösen, Geräte verwalten, Aktivierung ganz ohne Internetverbindung.
• Gemeinsame Ablagen: lokale Asset-Bibliothek und Brandkits, die in allen Apps der Suite wirken.
• Automatisierung: Der MCP-Host für KI-Agenten wird ausschließlich über AnnexHub gestartet.

AnnexHub selbst ist kostenlos und bildet das Fundament des „Creative OS" AnnexCREATE.

2. Installation & Aktivierung

AnnexHub installierst du als erste App der Suite aus dem bereitgestellten Installationspaket (.dmg oder .zip). Beim ersten Start erscheint ein Onboarding-Sheet.

• AnnexHub ist kostenlos – für die App selbst wird keine Lizenz benötigt.
• Lizenzen für die anderen Apps aktivierst du in AnnexHub im Bereich Lizenzen (⌘2): online per Lizenzschlüssel oder offline über eine signierte Aktivierungs-Datei (.annex-request erzeugen, Offline-Token einlesen).

Offline-first: Die lokalen Bereiche (Bibliothek, Brandkits, Suche, Downloads, Einstellungen, App-Verwaltung für installierte Apps) funktionieren ohne Serververbindung. Server-abhängige Bereiche (Store-Assets, Teams, Update-Check) zeigen bei fehlender Verbindung einen ehrlichen Hinweis – lokale Inhalte bleiben verfügbar.

3. Grundworkflow

Der typische Einstieg in die Suite:

1. AnnexHub starten und das Onboarding durchgehen.
2. Lizenz aktivieren: Im Bereich Lizenzen den Lizenzschlüssel einlösen – oder die Offline-Aktivierung nutzen.
3. Apps installieren: Im Bereich Apps (⌘1) die gewünschten Suite-Apps installieren bzw. aktualisieren und von dort direkt öffnen.
4. Brandkit anlegen: Im Bereich Brandkits Farben, Schriften und Formate der eigenen Marke definieren – wirkt anschließend in allen Apps.
5. Assets pflegen: In der Bibliothek (⌘4) Bilder, Grafiken und Dateien mit Tags, Kunden und Projekten verwalten.
6. Dokument starten: Über „Neues Dokument" ein Template wählen – AnnexHub erzeugt die Datei und startet die Ziel-App.
7. Aktuell bleiben: Über AnnexHub ▸ Nach Updates suchen… den Update-Check für alle Suite-Apps anstoßen.

4. Kernfunktionen

App-Verwaltung

Der Bereich Apps (⌘1) listet alle zehn Suite-Apps mit Installationsstatus, Version und Accent-Farbe. Du installierst Apps aus heruntergeladenen .zip- oder .dmg-Archiven nach /Applications, deinstallierst sie in den Papierkorb und öffnest installierte Apps direkt. Der Update-Check pro App läuft über den Server, inklusive Changelog-Anzeige und Kennzeichnung pflichtiger Updates.

Lizenzverwaltung und Geräteverwaltung

Der Bereich Lizenzen (⌘2) zeigt den Lizenzstatus pro Komponente als Kartenraster. Du löst Lizenzschlüssel online über die Server-API ein oder nutzt die Offline-Aktivierung: signierten Aktivierungs-Request als .annex-request-Datei erzeugen, Offline-Token-Datei einlesen und anwenden. Lizenzschlüssel werden im SecretStore abgelegt; in den Einstellungen kannst du den lokalen Lizenzcache zurücksetzen. Die Geräteverwaltung listet die aktivierten Macs pro Lizenz (Gerätename, maskierte Hardware-ID, Zeitpunkte; aktuelles Gerät markiert) und erlaubt Remote-Deaktivierung mit Bestätigungsdialog – deaktivierst du das eigene Gerät, wird die Lizenz lokal entfernt.

Team-Management

Im Bereich Teams lädst und erstellst du Teams, lädst Mitglieder per E-Mail ein (Rollen owner/admin/member/guest), entfernst sie und übergibst übertragbare Lizenzen. Pro Team stehen Asset-Sync und Versions-Sync der Dokument-Index-Ebene bereit (last-write-wins); beide setzen eine erreichbare Server-API und eine gültige Lizenz voraus.

Lokale Asset-Bibliothek

Die Bibliothek (⌘4) ist die lokale Asset-Ablage der Suite: Assets, Tags, Kunden und Projekte verwalten, nach Typ/Tag/Kunde/Projekt filtern und per Freitext suchen. Ein Thumbnail-Grid zeigt die Inhalte, der Inspector die Metadaten (Maße, Format, Dateigröße, Notiz, Tags). Die Bibliothek wird auch von den anderen Apps genutzt.

Store-Assets (Server)

Der Bereich Store-Assets (⌘3) listet die Inhalte des Stores (Content Packs, Templates, Plugins, Stock) mit Typ, Beschreibung und Größe. Ist der Server nicht erreichbar, zeigt die Ansicht einen ehrlichen Hinweis mit Erneut-versuchen-Button; lokale Inhalte bleiben davon unberührt.

Brandkit-Verwaltung

Im Bereich Brandkits legst du Brandkits an, bearbeitest, duplizierst und löschst sie: Farbpaletten mit Farbrollen und Harmonie-Generatoren, Schrift-Whitelist, Absatz- und Zeichenformate sowie Verknüpfung mit Assets aus der lokalen Bibliothek. Änderungen wirken über die geteilte Ablage suite-weit in allen Apps.

Schriften verwalten

Unter Marke → Schriften verwaltest du die Schriften der Suite zentral. Die Ansicht zeigt die verwalteten Schriften als Liste; jeder Eintrag nennt Familie, enthaltene Schnitte, Lizenzangabe und Bezugsquelle.

Schriften importieren

Klicke auf den Import-Button oder ziehe Schriftdateien in die Ansicht. AnnexHub unterstützt die Formate TTF, OTF, TTC, dfont, WOFF und WOFF2. Beim Import liest AnnexHub Familie und Schnitte über CoreText aus und registriert die Schrift anschließend bei CoreText, damit sie in allen Apps verfügbar ist.

Falls eine Datei nicht importiert werden kann, nennt AnnexHub den Grund statt sie stillschweigend zu überspringen:

• Nicht unterstütztes Format – Dateiendung außerhalb der genannten Formate.
• Nicht lesbar – die Datei ist beschädigt oder enthält keine gültigen Schriftmetadaten.
• Duplikat – alle Schnitte der Datei sind bereits im Bestand vorhanden.

Fähigkeiten erkennen

In der Schriftenliste und im Font-Picker zeigt AnnexHub für jede Schrift die Badges OpenType und Variable an. Unterstützt die Schrift die jeweilige Fähigkeit, erscheint der Badge farbig; andernfalls ist er ausgegraut. Die Badges fehlen nie und sind nie wirkungslos aktiv – so erkennst du auf einen Blick, welche Fähigkeiten tatsächlich zur Verfügung stehen.

Favoriten und Sammlungen

Markiere häufig verwendete Schriften als Favorit per Stern in der Zeile. Ordne Schriften über Sammlungen zu, damit sie in der geteilten Schriftauswahl als eigener Abschnitt und Filter erscheinen. Favoriten und Sammlungen wirken in allen Apps der Suite, die die zentrale Schriftauswahl nutzen.

Zentrale Suche

Die Suche durchsucht den lokalen Versions-Index, den die Apps beim Speichern befüllen. Du filterst nach Freitext (Titel/Dateiname/Bearbeiter) und Freigabe-Status und sortierst nach Änderungsdatum, Titel, Status oder Versionsanzahl.

Plugin-Store

Der Plugin-Store (⌘5) zeigt die Plugin-Liste aus den Server-Assets; Plugins lassen sich installieren (mit Download) sowie aktivieren und deaktivieren – die Aktivierung überlebt App-Neustarts. Ein internes Demo-Plugin registriert einen Beispielbefehl und wird nur in Debug-Builds automatisch aktiviert; externe Plugin-Bundles werden noch nicht geladen.

Download-Manager

Der Bereich Downloads zeigt laufende und abgeschlossene Downloads mit Fortschrittsanzeige (Bytes, Prozent, Status: ausstehend/lädt/abgeschlossen/fehlgeschlagen).

Tutorials

Der Bereich Tutorials (⌘6) bündelt die Dokumentation der Suite: Für jede der zehn Apps öffnest du das Handbuch und das Kurz-Tutorial direkt im eingebauten Reader – die Dokumente sind im Hub gebündelt und stehen damit offline zur Verfügung (Sprachauswahl nach App-Sprache, Fallback Deutsch/Englisch). Ist für eine App ein Tutorial-Video gebündelt oder bereits geladen, spielt der integrierte Player es ab; andernfalls kannst du das Video auf Wunsch vom Server laden (wird lokal gecacht) oder den ehrlichen Hinweis sehen, dass es noch nicht verfügbar ist.

Neues Dokument aus Template

Über „Neues Dokument" erreichst du den Template-Katalog der übrigen neun Apps, gruppiert nach App, mit Vorschau und Format-Hinweis. AnnexHub erzeugt eine echte Datei im Format der Ziel-App und startet diese (Fallback: Datei im Finder zeigen).

Feedback-Formular

Das Feedback-Formular nimmt Kategorie, Freitext und optionalen Kontakt entgegen. Es wird nur auf explizites Absenden übertragen – es gibt kein Telemetrie-Pendant.

Einstellungen und Menüleiste

Die Einstellungen bündeln Theme/Farbschema, Diagnostik und Datenschutz, die konfigurierbare Server-URL (leer = Standard http://localhost:8080/v1, Validierung auf http(s)://, „Standard"-Button zum Zurücksetzen), den Lizenzcache-Reset und die Versionsanzeige.

Die Menüleiste enthält:

• AnnexHub ▸ Nach Updates suchen… – Update-Check für alle Suite-Apps (kein Tastaturkürzel)
• AnnexHub ▸ Einstellungen… (⌘,)
• Darstellung ▸ Apps (⌘1), Darstellung ▸ Lizenzen (⌘2), Darstellung ▸ Store-Assets (⌘3), Darstellung ▸ Bibliothek (⌘4), Darstellung ▸ Plugin-Store (⌘5), Darstellung ▸ Tutorials (⌘6)

Die Oberfläche ist auf Deutsch, Englisch, Spanisch, Französisch und Italienisch lokalisiert.

5. Formate & Interoperabilität

Kein eigenes Dokumentformat: AnnexHub ist eine Verwaltungs-App und erzeugt keine eigenen Container-Dokumente.

• Installer-Formate: App-Installation aus .zip- und .dmg-Archiven.
• Offline-Lizenzierung: Aktivierungs-Request als .annex-request-Datei (Export); signierter Offline-Token (abgelegt als offline-license.annex unter ~/Library/Application Support/AnnexCREATE/Licenses/).
• Template-Erzeugung: echte Dateien in den Formaten der Ziel-Apps (z. B. .axd, .axtext, .axsheet, .axpublish), anschließendes Öffnen der Ziel-App.

Geteilte Stores (Suite-Interop):

• Asset-Bibliothek als gemeinsame SQLite-Ablage im Application-Support – auch in anderen Apps genutzt.
• Geteilter Versions-Index: Die Apps schreiben beim Speichern, AnnexHub liest für die zentrale Suche.
• Geteilte Brandkit-Ablage (brandkits.json im Application-Support), wirkt in allen Apps.

App-Steuerung: Apps und Dokumente werden über Bundle-IDs (com.annexcreative.<app>) geöffnet.

Server-Anbindung: HTTP-API unter http://localhost:8080/v1 (Standard; in den Einstellungen konfigurierbar, z. B. für eine Server-/Proxy-Installation im LAN) für Lizenzen, Teams, Updates und Assets. iCloud-Sync ist nicht verdrahtet.

6. MCP-Bedienung

Der MCP-Host der Suite läuft in AnnexHub (JSON-RPC 2.0 via STDIO) und wird beim App-Start automatisch gestartet – ausschließlich von hier. Über ihn steuern KI-Agenten die Apps der Suite.

Suite-Tools (für alle Apps):

• list_apps – listet alle verfügbaren Annex-Apps mit Installationsstatus und Version.
• open_app – öffnet eine Annex-App anhand ihrer ID.
• open_document – öffnet eine Datei in der angegebenen Annex-App.
• get_active_document – gibt Informationen zum aktiven Dokument einer App zurück.
• get_license_status – gibt den Lizenzstatus eines Annex-Produkts zurück.
• search_assets – durchsucht die zentrale Asset-Bibliothek nach Name oder Tags.

AnnexHub stellt außerdem zwei eigene Tools bereit:

• hub_tutorials_list – listet alle Apps mit der Verfügbarkeit von Handbuch, Tutorial und Tutorial-Video.
• hub_open_tutorials – öffnet den Tutorials-Bereich im Hub-Fenster.

Die app-spezifischen Tools (z. B. text.create_document, calc.set_cell, design.open_document) sind in den Feature-Listen und Handbüchern der jeweiligen Apps dokumentiert.

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

7. Diagnostik & Privatsphäre

AnnexHub protokolliert Fehler und Aktionen lokal über AnnexLog in rotierende JSON-Log-Dateien unter ~/Library/Logs/AnnexCREATE/AnnexHub/, gespiegelt nach os_log (Subsystem com.annexcreative.annexhub). Die Protokolle werden mit einem PII-Filter geschrieben. Die Diagnostik ist in der Entwicklungsphase standardmäßig aktiv und in den Einstellungen (Datenschutz) abschaltbar; es findet keine Übertragung statt.

Telemetrie läuft ausschließlich per Opt-in (Standard: aus). Feedback wird nur auf explizites Absenden übertragen. Lizenzschlüssel liegen im SecretStore; UserDefaults enthält nur redigierte Kopien.

8. FAQ

Kostet AnnexHub etwas? Nein. AnnexHub ist kostenlos; Lizenzen werden nur für die anderen Apps der Suite benötigt.

Kann ich AnnexHub ohne Serververbindung nutzen? Ja. Bibliothek, Brandkits, Suche, Downloads und die Verwaltung installierter Apps funktionieren offline. Store-Assets, Teams und der Update-Check benötigen den Server – ist er nicht erreichbar, zeigt die App das ehrlich an.

Wie aktiviere ich eine Lizenz ohne Internet? Über die Offline-Aktivierung im Bereich Lizenzen: AnnexHub erzeugt eine signierte .annex-request-Datei; den dazugehörigen Offline-Token liest du anschließend ein und wendest ihn an.

Wo werden meine Lizenzschlüssel gespeichert? Im SecretStore. In UserDefaults liegen nur redigierte Kopien; den lokalen Lizenzcache kannst du in den Einstellungen zurücksetzen.

Was passiert, wenn ich mein eigenes Gerät remote deaktiviere? Die Lizenz wird auf diesem Mac lokal entfernt. Die Deaktivierung erfolgt erst nach einem Bestätigungsdialog.

Erstellt AnnexHub eigene Dokumente? Nein. AnnexHub ist eine Verwaltungs-App. Über „Neues Dokument" erzeugt sie Dateien im Format der Ziel-App und startet diese.

Werden externe Plugins geladen? Noch nicht. Aktuell wird nur das interne Demo-Plugin aktiviert (nur in Debug-Builds automatisch); externe Plugin-Bundles sind als späterer Schritt vorgesehen.

Wo starte ich den MCP-Host für KI-Agenten? Automatisch mit dem Start von AnnexHub – der MCP-Host ist ausschließlich hier beheimatet.