AIHook Desktop Handbuch

1. Was ist AIHook Desktop

AIHook Desktop ist eine Windows-Anwendung, die an einem Ort vereint:

• Chat mit KI-Modellen - Hunderte Modelle verschiedener Anbieter (Anthropic, OpenAI, Google, Mistral, Meta und weitere) über ein Konto und ein Guthaben.
• Code-Tab - ein lokaler Programmier-Agent, der Code direkt in Ihrem Projekt auf der Festplatte liest, bearbeitet und erstellt.
• Agenten - fertige Arbeitsabläufe (z. B. Verarbeitung gescannter Dokumente, OCR, Export nach Word oder XML).
• Gedächtnis (RAG) - das Modell merkt sich Ihre Dokumente und frühere Gespräche.

Was wichtig zu wissen ist:

• Ein Guthaben, alle Modelle. Sie zahlen nur den Verbrauch nach der Preisliste des Modells (in Euro). Kein Abonnement.
• Ihre Daten bleiben bei Ihnen. Gespräche, Projekte und Gedächtnis werden lokal in einer Datenbank neben der Anwendung gespeichert. Zum Server werden nur Anfragen an das KI-Modell gesendet.
• Portabel. Sie können die Anwendung samt Daten auf einem USB-Stick haben und auf einem anderen Computer starten.
• Eine Produktionsadresse. Die installierte Anwendung kommuniziert ausschließlich mit dem Server https://app.aihook.dev.

2. Installation und erster Start

2.1 Zwei Distributionsformen

2.2 Wo die Daten liegen

Die Daten liegen immer neben dem Programm:

<Anwendungsordner>\
  AIHook.exe
  data\        <- Gesprächsdatenbank, Gedächtnis (RAG), Einstellungen
  projects\    <- Arbeitsordner der Projekte (falls die App sie anlegt)

Folgen:

• Eine Sicherung erstellen Sie durch Kopieren des gesamten Ordners.
• Beim Umzug auf ein anderes Laufwerk/einen anderen PC werden gespeicherte Pfade automatisch neu berechnet (Arbeitsordner unterhalb des Anwendungsordners werden relativ gespeichert).
• Aktualisierung auf eine neue Version: Installieren Sie die neue Version über die bestehende oder entpacken Sie die ZIP-Datei in denselben Ordner - die Daten in data\ bleiben erhalten.
• Bei der Deinstallation bleiben die Daten standardmäßig erhalten.

2.3 Erster Start

1. Es erscheint ein Willkommensfenster mit der Anmeldung (E-Mail + Passwort Ihres AIHook-Kontos).
2. Sprache: Beim allerersten Start verwendet die App die Sprache Ihres Betriebssystems (Slowakisch, Tschechisch, Deutsch, Englisch), sonst Englisch. Sie können sie mit den Schaltflächen im Willkommensfenster oder später in den Einstellungen ändern; Ihre Wahl wird danach nie überschrieben.
3. Nach der Anmeldung lädt die App die Liste der Modelle und Agenten.
4. Wenn Sie noch keine Verknüpfung auf dem Desktop haben, bietet die App sie an (eine bestehende wird nie überschrieben).
5. Laden Sie Guthaben auf (Einstellungen → Konto → Guthaben aufladen) und Sie können schreiben.

Konto und Guthaben werden auf der Website app.aihook.dev verwaltet (Registrierung, Rechnungen, Teams). Die Anwendung dient der Arbeit mit KI.

3. Fensteraufbau

┌────────────────────────────────────────────────────────────┐
│ ● AIHook          Gesprächstitel        (€ 12.34) 🌙 ⚙ – ▢ ✕│  Titelleiste
├───────────────┬────────────────────────────────────────────┤
│ ⌂ Chat │ </> Code │ ⚡ Agent │                                │
│ + Neues Gespräch │       Chat- / Agentenbereich             │
│ 🔍 Suchen…    │                                            │
│ PROJEKTE      │                                            │
│ HEUTE         │  ───────────────────────────────────────── │
│  Gespräche    │  [Eingabezeile + Werkzeugleiste]            │
│ Mein Konto ⚙ │                                            │
└───────────────┴────────────────────────────────────────────┘

Titelleiste

• Guthabenstand (grüner Punkt + Betrag in €); ein Klick öffnet Einstellungen/Konto.
• Themenumschalter (dunkel/hell), Einstellungen (Zahnrad).
• Minimieren / Maximieren / Schließen. Schließen (✕) blendet die Anwendung in den Infobereich aus - sie läuft weiter. Vollständig beenden: Rechtsklick auf das Symbol im Infobereich → Beenden.

Linke Leiste (Sidebar)

• Drei Tabs: Chat, Code, Agent.
• Schaltfläche Neues Gespräch, Suche in Gesprächen.
• Projekte (aufklappbar), darunter nach Tag gruppierte Gespräche.
• Unten: angemeldeter Benutzer, Guthaben und Zahnrad.

4. Chat (Tab ⌂ Chat)

Ein gewöhnliches Gespräch mit einem KI-Modell.

4.1 Nachricht senden

• Enter sendet, Umschalt+Enter fügt eine neue Zeile ein.
• Die Antwort wird schrittweise angezeigt (Streaming). Sie können sie mit der Stopp-Schaltfläche anhalten.
• Unter der letzten Antwort befindet sich Regenerate - die Antwort wird erneut erzeugt.
• Jede Antwort hat eine Schaltfläche Kopieren. Antworten mit JSON bieten Export nach Word (DOC) und DASTA XML (für Gesundheitsagenten).
• Blöcke ```svg werden als Bild mit den Download-Schaltflächen SVG / PNG / JPG dargestellt.

4.2 Modellauswahl

Ein Klick auf den Modellnamen über dem Eingabefeld öffnet die Modellauswahl:

• Auto - automatische Auswahl nach Kontext.
• Suche nach Namen.
• Filter: Alle, ★ Favoriten, EU/GDPR, Code, Reasoning, Tools.
• Kennzeichen bei Modellen: EU (europäischer Anbieter), Code, Reason, Vision (sieht Bilder), OCR, Tools (unterstützt Werkzeuge/Dateien).
• Der Stern ★ fügt ein Modell zu den Favoriten hinzu.
• Sortierung nach Preis.
• Der Modellpreis ist immer der Verkaufspreis in €:
• IN = Preis für die Eingabe (was Sie senden), OUT = Preis für die Ausgabe (die Antwort),
• nach Seiten abgerechnete Modelle (OCR) zeigen €x.xxxx/Seite,
• „—" = Preis nicht verfügbar, „kostenlos" = kostenloses Modell.
• Die Auswahl wird für jedes Gespräch separat gespeichert.

Die Preiseinheit schalten Sie in den Einstellungen um (1K = pro 1.000 Token, Standard, oder 1M = pro Million Token).

4.3 Kontextanzeige

Beim Modell steht eine Angabe Xk / Yk (Z %) - wie viel des Kontextfensters des Modells belegt ist. Farbe: grau → orange (ab 50 %) → rot (ab 80 %).

Ist der Kontext voll, komprimiert die App den alten Verlauf automatisch (Zusammenfassung durch ein günstiges Modell, die letzten Nachrichten bleiben) - siehe Einstellungen → Komprimierung.

4.4 Werkzeugleiste an der Eingabe

4.5 Erwähnungen @

Geben Sie im Feld @ ein und wählen Sie:

• @Datei - fügt den Inhalt einer Datei aus dem Arbeitsordner ein,
• @Ordner - fügt den Ordnerbaum ein,
• @url - fügt den Inhalt einer Webseite ein.

4.6 Entwürfe und angefangene Texte

Ein angefangener Text wird als Entwurf für jedes Gespräch gespeichert - beim Wechsel zu einem anderen Gespräch und zurück geht er nicht verloren und wird nach dem Senden gelöscht.

5. Gespräche und Projekte

Gespräche

• Der Titel wird automatisch aus der ersten Nachricht erzeugt (erste 60 Zeichen); per Doppelklick können Sie ihn umbenennen.
• Ältere Inhalte werden beim Hochscrollen schrittweise nachgeladen (je 50 Nachrichten).
• Das Löschen erfordert eine Bestätigung im Anwendungsfenster.
• Ein Gespräch können Sie mit der Maus in ein Projekt ziehen (oder zurück in den Tagesbereich).

Projekte

Ein Projekt gruppiert Gespräche und gibt ihnen gemeinsame Einstellungen:

• System-Prompt des Projekts - gilt für alle Chats im Projekt.
• Arbeitsordner des Projekts - Code/Agent im Projekt arbeitet in diesem Ordner (ein Gespräch kann ihn mit einem eigenen überschreiben).
• RAG-Quellen des Projekts - gemeinsames Gedächtnis für alle Gespräche des Projekts.
• Kontextmenü (⋯): Umbenennen / System-Prompt / RAG / Löschen.
• ＋ beim Projekt erstellt direkt darin einen neuen Chat.

6. Gedächtnis (RAG)

RAG ermöglicht dem Modell, auf Grundlage Ihrer Dateien und früherer Gespräche zu antworten, nicht nur aus eigenem Wissen.

So funktioniert es

1. Sie wählen eine Quelle (einen Ordner mit Dateien) und die App indiziert sie - teilt sie in Abschnitte und erzeugt über den Server Embeddings (numerische Fingerabdrücke der Bedeutung).
2. Bei jeder Nachricht sucht die App die ähnlichsten Abschnitte (Ähnlichkeit mindestens 0,25) und gibt sie dem Modell als Kontext mit.
3. Nach jeder Antwort wird das Paar Frage+Antwort automatisch im Gedächtnis des Chats gespeichert.

Gedächtnisquelle

• 💬 Chat - nur das aktuelle Gespräch.
• 🗂 Projekt - alle Gespräche und Dateien des Projekts (erscheint, wenn das Gespräch in einem Projekt liegt).

Gedächtnis-Panel (Rechtsklick auf das Symbol 🗄 oder „RAG" im Projektmenü)

• Liste der Quellen und Dateien, Filter, Suche im Inhalt, Entfernen von Dateien,
• verwaiste Dateien - Dateien, die indiziert wurden, aber nicht mehr auf der Festplatte sind (Entfernen / Behalten / Schließen),
• Indizierungsfortschritt, Gedächtnis löschen.

Embedding-Modell ändern In den Einstellungen können Sie das Embedding-Modell ändern. Die Änderung baut alle Embeddings neu auf - es erscheint ein Fortschrittsfenster, das sich nicht schließen lässt, die Anwendung lässt sich nicht beenden und setzt nach einem Neustart dort fort, wo sie aufgehört hat. In den Einstellungen → RAG wird das Modell aus der vom Server gelieferten Liste gewählt (Name und Preis in der gewählten Einheit 1K/1M, ohne Herkunftsangabe). So können Sie zu einem anderen Anbieter wechseln, falls einer ausfällt. Wird das gewählte Modell nicht mehr angeboten, ist es als "nicht verfügbar" markiert und Sie müssen ein anderes wählen.

Kosten: Embeddings werden wie andere Aufrufe vom Guthaben abgerechnet.

7. Code-Tab (</> Code) - lokaler Programmier-Agent

Der Code-Tab ist ein KI-Assistent, der direkt mit Ihrem Projekt auf der Festplatte arbeitet: Er liest Dateien, durchsucht sie, bearbeitet sie, führt Befehle aus und kompiliert.

7.1 Arbeitsbeginn

1. Neue Sitzung.
2. Wählen Sie einen Arbeitsordner (Schaltfläche 📁). Der Agent verlässt die erlaubten Ordner nie ohne Ihre Zustimmung.
3. Geben Sie eine Aufgabe ein und drücken Sie Enter.

7.2 Drei Modelle: Scout, Coder, Chat

Im Code-Tab stellen Sie bis zu drei unabhängige Modelle ein, jedes kann ein anderes sein:

Jede Auswahl ist eine kleine Dropdown-Liste mit Preis, genau wie im Chat.

7.3 Zwei Arbeitsmodi

Dual (Scout → Coder)

1. Der Scout (günstiges Modell) liest das Projekt, findet die relevanten Stellen und bereitet für den Coder eine Zusammenfassung und Auszüge aus großen Dateien vor.
2. Der Coder (teureres Modell) erhält sauberen Kontext und führt die Änderungen aus.
3. Handelt es sich nur um eine Frage oder Erklärung, antwortet der Scout selbst und ruft den Coder nicht auf - Sie sparen.

Vorteil: Das teure Modell verbrennt keine Token für das Durchsuchen des Projekts.

Plan/Act (ein Modell)

1. Plan - das Modell erkundet das Projekt und schlägt ein Vorgehen vor (es schreibt nicht).
2. Act - dasselbe Modell führt den Plan mit allen Werkzeugen aus.

Vorteil: einfacher, ein Modell, voller Kontext.

Während des Laufs sehen Sie ein Phasenlabel: 🔭 Scout analysiert → 📋 Planung → ⚡ Codierung / Ausführung und einen Zähler Iteration X/30 (der Agent hat eine Obergrenze von 30 Schritten). Mit der Stopp-Schaltfläche können Sie ihn jederzeit unterbrechen.

7.4 Denken (Thinking)

Für Modelle mit erweitertem Denken stellen Sie die Stufe ein: Aus, Niedrig, Mittel, Hoch, Max (Budget von etwa 1.024 / 8.192 / 32.768 / 65.536 Token für das Denken). Höhere Stufe = bessere, aber langsamere und teurere Antwort. Die Einstellung wird gespeichert. Es gibt außerdem ein Limit für Ausgabe-Token (Max tok.).

7.5 Werkzeuge des Agenten

Jeden Werkzeugaufruf sehen Sie in einer aufklappbaren „Blase" mit Argumenten und Ergebnis.

7.6 Berechtigungen und Sicherheit

Bei Schreibvorgängen und Befehlen erscheint ein Berechtigungsfenster:

• Einmal erlauben - nur diese Operation,
• Immer für Ordner - für den Rest der Sitzung für diesen Ordner,
• Auto (Arbeitsordner) - der Agent darf im gesamten Arbeitsordner ohne Nachfrage schreiben (grünes Label 🔓 Auto; per Klick ausschalten),
• Ablehnen. Ohne Antwort innerhalb von 5 Minuten wird die Operation abgelehnt.

7.7 Dateisicherungen (Checkpoints / Undo)

• Vor jeder Dateiänderung legt der Agent automatisch eine Sicherung in .aihook\checkpoints\ im Projekt ab (eine Sicherung je Datei und Sitzung, max. 30).
• Die Schaltfläche 🕐 in der Ordnerleiste zeigt die Sicherungen, und ↩ Wiederherstellen stellt den vorherigen Stand wieder her.
• In den Einstellungen abschaltbar (standardmäßig eingeschaltet).

7.8 Dateivorschau und Editor

Das rechte Panel zeigt Dateien, die der Agent erstellt oder geändert hat, und Sie können auch eigene öffnen:

• Editor mit Syntaxhervorhebung (einschließlich Pascal/Delphi) und Speichern,
• HTML-Vorschau, DOCX, XLSX/CSV, Bilder,
• mehrere Tabs gleichzeitig, Projektbaum (🗂), „Datei von der Festplatte öffnen".

7.9 Build

In der Ordnerleiste gibt es eine Build-Schaltfläche. Sie erkennt die Projektsprache anhand der Dateien und bietet einen Befehl an, den Sie anpassen können:

Delphi/Pascal, C#, Rust, Go, Java (Maven/Gradle), C/C++ (CMake/Make), Elixir, Zig, Haskell, JS/TS (npm/yarn/pnpm), TypeScript, Python (Syntaxprüfung), Arduino/ESP32 (arduino-cli / PlatformIO).

• Die Ausgabe wird laufend angezeigt, Fehler und Warnungen sind farbig hervorgehoben.
• 🤖 Fehler beheben sendet die Fehler automatisch an den Agenten.
• Änderungen am Befehl werden in .aihook\build.json im Projekt gespeichert.
• Für Delphi gibt es eine native Integration: Auswahl der Compilerversion, Win32/Win64, Debug/Release, Fehleranzahl.

7.10 Chat vs. Agent - wann was

8. Agent-Tab (⚡ Agent)

Agenten sind fertige Arbeitsabläufe, die ein Administrator auf dem Server eingerichtet hat (Modell, Prompt, Werkzeuge). Sie wählen nur einen Agenten und geben die Eingabe ein.

8.1 Verwendung

1. Klicken Sie auf die Agentenauswahl und wählen Sie einen aus (Suche nach Namen).
2. Schreiben Sie eine Nachricht oder hängen Sie eine Datei/einen Scan an (PDF, Bilder).
3. Der Agent verarbeitet die Eingabe und liefert das Ergebnis.

Die Gespräche im Seitenbereich werden nach dem gewählten Agenten gefiltert.

8.2 Was Agenten können

• Gescannte PDFs werden in Seiten zerlegt und nacheinander verarbeitet (Fortschritt „Konvertiere Seiten x/y").
• OCR mit zweiphasiger Verarbeitung: Zuerst wird sofort der extrahierte Text angezeigt, danach strukturiert ihn das Modell (z. B. in JSON).
• Export der Ergebnisse: Word (DOC) und DASTA XML (windows-1250, strukturierter Dateiname; bei mehreren Dokumenten werden sie im gewählten Ordner gespeichert).
• Arbeitsordner und Werkzeuge (der Agent kann mit Erlaubnis Dateien lesen/schreiben).

8.3 Watchdog (Ordnerüberwachung)

Ein Agent kann einen Ordner überwachen (👁): Sobald dort eine neue Datei erscheint, verarbeitet er sie automatisch und speichert das Ergebnis im Ausgabeordner. Eine grüne Anzeige zeigt, dass die Überwachung läuft. Beim Start werden auch Dateien verarbeitet, die schon im Ordner liegen.

8.4 Scanner

Die Scan-Schaltfläche ruft NAPS2 mit Ihrem Profil auf (Einstellungen → Allgemein → Scanner). Das gescannte Dokument wird an die Nachricht angehängt.

8.5 Sichtbarkeit der Agenten

Einstellungen → Agenten: Mit den Schaltern legen Sie fest, welche Agenten Sie in der Liste sehen möchten. Anzahl und Zugriff auf Agenten bestimmt der Kontoadministrator (global / ausgewählt / privat).

9. Einstellungen (⚙)

Verlaufskomprimierung

• Komprimierungsmodell - ein günstiges Modell für die Zusammenfassung (leer = das aktive wird verwendet).
• Schwelle (%) - bei welcher Kontextauslastung der Verlauf komprimiert wird (Standard 80 %).
• Die letzten Nachrichten bleiben im Originalwortlaut.

Modellsynchronisierung

• Die Modellliste wird beim Start, nach der Anmeldung und jede Stunde aktualisiert.
• Unter den Schaltflächen sehen Sie die Zeit der letzten Synchronisierung oder einen Fehler und eine Schaltfläche zum Wiederholen.
• Modelle, die der Server nicht mehr liefert, werden aus der Liste entfernt.
• Modell-Cache leeren löscht die lokale Liste und lädt sie neu.

10. Guthaben und Preise

• Das Guthaben wird nach jedem Aufruf abgebucht nach Tokenverbrauch (bzw. Seiten bei OCR).
• Der Kontostand steht immer in der Titelleiste; er wird nach jeder Antwort aktualisiert.
• Bei Guthaben null funktionieren die Modelle nicht, bis Sie aufladen.
• Die angezeigten Preise sind Verkaufspreise in Euro.
• Aufladen: Einstellungen → Konto → Guthaben aufladen (Zahlungsgateway in einem separaten Fenster); nach dem Schließen aktualisiert sich der Kontostand von selbst.

11. Datenschutz und Sicherheit

• Gespräche, Projekte und Gedächtnis sind lokal auf Ihrer Festplatte.
• Zum Server wird nur gesendet, was zur Beantwortung nötig ist: Nachrichten, ausgewählte Dateiauszüge und der RAG-Inhalt, der als Kontext hinzugefügt wird.
• Schreibvorgänge und Befehle des Agenten erfordern Ihre Erlaubnis (siehe 7.6).
• Der API-Schlüssel wird lokal gespeichert; in den Einstellungen ist er nur lesbar.
• Modelle mit der Kennzeichnung EU/GDPR verarbeiten Daten bei europäischen Anbietern.
• Geben Sie sensible Dokumente nicht in Modelle ein, denen Sie nicht vertrauen; prüfen Sie immer die Kennzeichnung des Modells.

12. Tastenkürzel

13. Problemlösung

14. Häufig gestellte Fragen

Brauche ich eigene API-Schlüssel für OpenAI/Anthropic? Nein. Alle Modelle sind über Ihr AIHook-Konto und ein Guthaben verfügbar.

Kann ich die App offline nutzen? Gespräche ansehen ja, KI-Antworten erfordern eine Verbindung.

Kann ich Scout und Coder von verschiedenen Anbietern haben? Ja, jede Rolle hat eine eigene Modellauswahl.

Wie viel kostet eine Antwort? Eine Schätzung finden Sie in der Modellauswahl (IN/OUT pro 1K oder 1M Token). Der tatsächliche Verbrauch wird nach der Antwort vom Guthaben abgebucht.

Kann man sichern? Durch Kopieren des Ordners data\ (die App muss geschlossen sein).

Ist die Anwendung für macOS/Linux verfügbar? Derzeit nur für Windows.

15. Geplante Funktionen

• Automatische Aktualisierung und Hinweis auf eine neue Version.
• Spracheingabe.
• Anzeige von Unterschieden (Diff) vor dem Anwenden von Agentenänderungen mit Bestätigung.
• Unterstützung für MCP-Server und Hooks.
• Git-Integration, Sub-Agenten, geplante Agentenläufe.
• Gruppierung der Gespräche nach Datum in der Seitenleiste.