Open Source Learning

Nicht nur nutzen. Selbst bauen.

Blitztext ist komplett offen. Lerne in sieben Stufen, es mit einem KI-Coding-Agenten selbst zu bauen, zu verstehen und zu deinem eigenen Werkzeug zu machen. Kostenlos, ohne Account, mit Prompts zum Kopieren.

Lernpfad startenCode auf GitHub

Dateien und Befehle beziehen sich auf Blitztext 1.13 für macOS.

Einen Mac

macOS 14 oder neuer. Für Stufe 0 reicht die App.

Xcode 26 und XcodeGen

Ab Stufe 1. Xcode ist ein großer Download, plan dafür Zeit ein.

Einen KI-Coding-Agenten

Zum Beispiel Claude Code, Codex, Cursor oder VS Code mit Agent. Der Anbieter rechnet selbst mit dir ab.

Der Lernpfad

Sieben Stufen. Ein eigenes Werkzeug.

Jede Stufe hat ein Ergebnis, das du selbst siehst. Davor kommt Stufe 0, ganz ohne Code. Ab Stufe 1 arbeitest du mit einem KI-Agenten, der dir den Code erklärt und mit dir ändert. Du entscheidest, was er tut.

  1. Stufe 0

    Ohne Xcode

    Ohne Code anpassen

    Blitztext+ schreibt in deinem Ton.

    Lade die App und öffne die Einstellungen unter Modi. Für Blitztext+ und Blitztext $%&! kannst du eine eigene Anweisung eintragen. Das ist der Kern von allem, was danach kommt: Eine Anweisung bestimmt, was das Modell aus deiner Sprache macht.

    Einstellungen > Modi > Eigene Anweisung
    Beispiel für deine eigene Anweisung

    Du bist mein Lektor. Mach aus meinem gesprochenen Text eine kurze, klare Nachricht in Du-Form. Wichtigster Punkt zuerst, höchstens drei Sätze, keine Floskeln. Gib nur den fertigen Text zurück.

    Die Schreib-Modi brauchen Apple Intelligence (macOS 26) oder einen eigenen Modell-Anbieter.

  2. Stufe 1

    Selbst bauen

    Deine eigene, selbst kompilierte Blitztext.app läuft in der Menüleiste.

    Ab hier arbeitest du mit dem Code und einem KI-Coding-Agenten im Terminal, zum Beispiel Claude Code oder Codex, oder du arbeitest im Agent-Chat von Cursor oder VS Code. Lass dir jeden Schritt erklären, bevor er ausgeführt wird. Du brauchst Xcode 26 und XcodeGen.

    $ brew install xcodegen$ git clone https://github.com/cmagnussen/blitztext-app.git$ cd blitztext-app$ ./build.sh --install --run
    Prompt für deinen Agenten

    Ich möchte Blitztext aus diesem Repository auf meinem Mac bauen. Prüfe zuerst, ob Xcode 26 und XcodeGen installiert sind. Erkläre mir jeden Schritt in einfachen Worten, bevor du ihn ausführst, und starte dann ./build.sh --install --run. Ändere keinen Code.

    Nach jedem neuen Build: Systemeinstellungen > Datenschutz & Sicherheit > Bedienungshilfen, alten Blitztext-Eintrag entfernen, neue App hinzufügen. Sonst landet der Text nicht am Cursor.

  3. Stufe 2

    Verstehen

    Du kannst erklären, was zwischen „Taste halten“ und „Text am Cursor“ passiert.

    Lass den Agenten einem Diktat durch den Code folgen, ohne etwas zu ändern. Blitztext ist klein genug, um es an einem Abend wirklich zu verstehen. Die Grafik unten zeigt den Weg.

    BlitztextMac/BlitztextShared/README.md
    1. 1. AufnahmeAudio​RecorderMac
    2. 2. ErkennungLocal​Transcription​ServiceMac
    3. 3. AufräumenTranscript​Post​ProcessorMac
    4. 4. KI-ModusText​Rewriter + Mode​PromptsMac oder dein Anbieter
    5. 5. Am CursorClipboard​Paste​ServiceMac

    Nur der KI-Modus kann den Mac verlassen, und nur, wenn du selbst einen Modell-Anbieter einträgst. Die Aufnahme bleibt immer auf dem Mac.

    Prompt für deinen Agenten

    Erkläre mir die Architektur von Blitztext, ohne etwas zu ändern. Folge einem Diktat von der gedrückten Taste bis zum Text am Cursor und nenne zu jedem Schritt die Datei. Welche Teile laufen auf dem Mac, welche können ins Netz gehen, und warum?

  4. Stufe 3

    Erste Änderung

    Ein eingebauter Modus verhält sich anders, weil du den Code geändert hast.

    Alle Anweisungen der KI-Modi stehen in einer einzigen Datei. Ändere eine davon, bau neu und diktiere. Du merkst den Unterschied beim nächsten Satz.

    BlitztextShared/AI/ModePrompts.swift
    Prompt für deinen Agenten

    Ändere in BlitztextShared/AI/ModePrompts.swift die Anweisung für den Emoji-Modus so, dass Emojis nur am Ende eines Satzes stehen. Zeig mir den Diff und erkläre ihn, bevor du mit ./build.sh --install --run neu baust.

    Die Datei wird auch von der iPhone-App genutzt. In deinem Fork ist das egal, für einen Pull Request nicht.

  5. Stufe 4

    Eigener Modus

    Blitztext hat einen fünften Modus, gebaut für deine Arbeit.

    Zum Beispiel Protokoll, Ticket, LinkedIn-Post oder Einfache Sprache. Ein neuer Modus berührt fünf Stellen im Code. Lass den Agenten erst einen Plan machen und dann Schritt für Schritt umsetzen. Das Tastenkürzel legst du danach in den Einstellungen fest.

    Features/Workflows/WorkflowProtocol.swiftFeatures/Workflows/EmojiTextWorkflow.swift (Vorlage)BlitztextShared/AI/ModePrompts.swiftApp/AppState.swiftApp/MenuBarStatusController.swift
    Prompt für deinen Agenten

    Füge Blitztext einen neuen Modus „Protokoll“ hinzu, der aus gesprochenen Stichpunkten Entscheidungen und To-dos macht. Nimm den Emoji-Modus als Vorlage. Finde zuerst alle Stellen, an denen Modi registriert sind, und schreib mir einen Plan. Setz ihn erst um, wenn ich zustimme. Der Modus bekommt kein fn-Kürzel, sondern ein eigenes Kürzel über die Einstellungen.

    Wenn der Build scheitert, gib dem Agenten die komplette Fehlermeldung. Meist fehlt ein Fall in einem switch.

  6. Stufe 5

    Eigener Name

    Deine Version hat eigenen Namen, eigenes Icon und eigene Bundle-ID.

    Der Code steht unter MIT-Lizenz, Name und Logo von Blitztext nicht. Bevor du deinen Fork zeigst oder weitergibst, bekommt er eine eigene Identität. Wer eine App für andere veröffentlicht, signiert sie mit der eigenen Developer ID.

    BlitztextMac/project.ymlBlitztextMac/Resources/AppIcon.icnsTRADEMARKS.md
    Prompt für deinen Agenten

    Mach aus diesem Fork eine eigene App: neuer Name, eigene Bundle-ID und ein Platzhalter-Icon. Halte dich an TRADEMARKS.md und liste mir danach alle Stellen auf, an denen noch Blitztext oder Blackboat sichtbar ist.

  7. Stufe 6

    Teilen

    Andere sehen, was du gebaut hast.

    Gib deinem Fork einen eigenen Namen und zeig ihn: im Team, auf LinkedIn oder in deinem GitHub-Profil. Hast du etwas verbessert, das allen hilft, schick einen kleinen Pull Request zurück und schreib dazu, wie du ihn getestet und ob du KI genutzt hast.

    CONTRIBUTING.md
    Prompt für deinen Agenten

    Bereite einen Pull Request für diese Änderung vor. Halte ihn klein, schreib nach der Vorlage in .github/PULL_REQUEST_TEMPLATE.md, was sich geändert hat, warum, wie es getestet wurde und dass ein KI-Agent beteiligt war. Prüfe, dass keine API-Keys oder privaten Aufnahmen im Commit sind.

Challenges

Bau etwas, das du morgen nutzt.

Kleine Aufgaben mit sichtbarem Ergebnis. Such dir eine aus, bau sie in deinem Fork und zeig sie deinem Team.

Stufe 4

Einfache Sprache

Ein Modus, der jeden diktierten Text in leicht verständliche Sprache übersetzt.

Stufe 4

Meeting-Notiz

Aus gesprochenen Stichpunkten werden Entscheidungen, Verantwortliche und To-dos.

Stufe 0 bis 3

Dein Fachwortschatz

Wörterbuch und Ersetzungen für deine Branche, damit Fachbegriffe richtig geschrieben werden.

Profi

Neue Plattform

Die Blitztext-Idee für Windows oder Linux. Die Community-Projekte zeigen, dass es geht.

Videokapitel

Zuschauen, dann nachbauen.

Christoph zeigt auf YouTube, wie er mit KI baut, Blitztext inklusive. Kurze Kapitel zu den einzelnen Stufen sind in Vorbereitung.

Zum YouTube-Kanal

Teilen

Zeig, was du gebaut hast.

Gib deinem Fork einen eigenen Namen und zeig ihn, wo deine Leute sind: im Team, auf LinkedIn, in deinem GitHub-Profil. Hast du etwas verbessert, das allen hilft, schick einen kleinen Pull Request. Eigene Modi gehören in deinen Fork.

Forks auf GitHub ansehenSo machst du mit

Spielregeln

Offen heißt nicht beliebig.

Dein Fork, dein Name

Der Code ist MIT-lizenziert, Name und Icon von Blitztext nicht. Zeigst du deinen Fork, gib ihm eine eigene Identität.

Markenhinweise

Fremde Forks sind nicht geprüft

Blitztext braucht Mikrofon und Bedienungshilfen, also weitreichende Rechte. Bau fremde Forks lieber selbst aus dem Quellcode, statt eine fertige App zu laden.

Lernen ohne Betreuung

Das hier ist ein Pfad zum Selbermachen, Blitztext ist keine offiziell unterstützte App. Fragen beantworten wir trotzdem gern unter support@blackboat.com, echte Fehler nehmen wir als Issue entgegen.

Issue aufmachen

Kosten kennen

Blitztext ist kostenlos. Dein KI-Agent und ein eigener Modell-Anbieter können Geld kosten, je nach deinem Tarif dort.

Für Teams

Vom eigenen Werkzeug zum eigenen Arbeitssystem.

Was du mit Blitztext lernst, funktioniert auch für die Prozesse in deinem Unternehmen. Blitztext ist ein Use Case aus der Blackboat Academy, dort teilen wir viele dieser Learnings. Wenn ihr das als Team angehen wollt, sprecht mit uns.

Zur Blackboat AcademyBlackboat kennenlernen