Thinking Orbs

Thinking Orbs

Yogesh (yogesharc) · Coding

Thinking Orbs ist eine Open-Source-Bibliothek mit React-Komponenten, deren animierte Orbs zeigen, was ein KI-Agent in jedem Moment tut.

Vorschau der Oberfläche von Thinking Orbs

Über Thinking Orbs

About

Was ist Thinking Orbs

Thinking Orbs ist eine React-Bibliothek, die animierte Orbs für Oberflächen von KI-Agenten zeichnet. Jeder Orb ist eine Kugel aus Punkten, und jeder Zustand verändert die Bewegung dieser Punkte. Während der Assistent nachdenkt, wandert ein Funke über die Oberfläche. Sucht er im Web, springt eine Linse von Stelle zu Stelle. Versucht er es nach einem Fehler erneut, dreht sich der Orb und rollt sich zurück.

Die Bibliothek gibt es, weil Agenten-Oberflächen viel Zeit in einem unbestimmten Arbeitszustand verbringen. Ein Spinner sagt nichts darüber, was das Modell tut, und Nutzer können eine langsame Antwort nicht von einer hängenden Anfrage unterscheiden. Dieser animierte Orb macht aus der Leerlaufzeit ein lesbares Signal, in einer Größe, die neben eine Textzeile passt.

Yogesh veröffentlicht das Paket als Open Source unter der MIT-Lizenz. Der React-Orb braucht nur React, die reine JavaScript-Version braucht gar nichts, und das SwiftUI-Paket deckt iOS 17 und macOS 14 ab. Formen und Renderer jenseits der Voreinstellung kommen als eigene Module, sodass jedes Projekt nur bündelt, was es importiert.

Die Grenzen sollten Sie vor der Installation kennen. Die Komponente animiert, verfolgt Ihren Agenten aber nicht. Sie entscheiden, welcher Zustand zu sehen ist und wann er wechselt, meist aus Ihrem eigenen Anfragezyklus heraus. Formen und Renderer bleiben vorerst dem Web vorbehalten, und die SwiftUI-Version nimmt weniger Optionen an.

Erste Schritte

  1. Installieren Sie das Paket mit npm, pnpm, yarn oder bun: npm i @yogesharc/thinking-orbs.
  2. Importieren Sie Orb und übergeben Sie einen Zustand, etwa reasoning oder searching.
  3. Stellen Sie size, speed, density und tilt so ein, dass der Orb zu Ihrem Text passt, und ergänzen Sie label für Screenreader.
  4. Importieren Sie eine Form oder einen Renderer aus den optionalen Modulen, wenn die Kugel anders aussehen soll.
  5. Oder kopieren Sie den Code mit dem shadcn-Befehl nach components/ und bearbeiten ihn als eigene Datei.

Produktinformationen

Ein kurzer Überblick über Preise, unterstützte Plattformen und die Leistung von Thinking Orbs.

Kostenloser TarifJa
Bezahlte Tarife$0 (MIT license)
PlattformWeb (React, vanilla JS), iOS 17+, macOS 14+
EntwicklerYogesh (yogesharc)
KategorieCoding
VeröffentlichungsdatumSep 2026
Zuletzt aktualisiertOct 2026
Website-BesucheN/A
Globales Website-RankingN/A
API-VerfügbarkeitNein

Am besten für

Die Nutzer, Aufgaben und Szenarien, für die dieses Tool am besten passt.

Nutzer

  • React-Entwickler, die einen Chat oder ein Agentenprodukt bauen
  • Frontend-Entwickler in kleinen Teams ohne Designer
  • Einzelentwickler mit einem Nebenprojekt

Aufgaben

  • Nachdenken und Websuche in einem Streaming-Chat trennen
  • Lange Arbeit im Hintergrund zeigen, etwa eine Indexierung oder eine Aufgabe im Stil eines Entwicklungsservers
  • Auf einen neuen Versuch oder ein Nutzungslimit hinweisen
  • Ein leeres Panel füllen, während ein Werkzeugaufruf zurückkommt

Szenarien

  • Eine Chat-App, die Tokens streamt und neben der Antwortüberschrift einen Status braucht.
  • Ein Coding-Agent oder ein Editor-Plugin, in dem Werkzeugaufrufe aufeinander folgen und jeder ein eigenes Signal braucht.
  • Eine SwiftUI-App für iPhone oder Mac, die dieselbe Bildsprache wie die Webversion will.

Wichtigste Funktionen

Eine Statusanzeige für jede Agentenaktion

Die Bibliothek deckt neun Zustände ab, gedacht für die Schleife eines Agenten: laufende Arbeit, Nachdenken und Suche zuerst, danach Hintergrundaufgaben, Browsersteuerung, neue Versuche, Kontextverdichtung, Warten auf ein Nutzungslimit und Leerlauf. Die meisten haben benannte Varianten, gyro lässt einen Arbeits-Orb schwanken, lighthouse schwenkt einen Suchstrahl.

Props, die das Aussehen ohne CSS abstimmen

Size, speed, density, dotSize und tilt sind simple Zahlen-Props. Damit passt der Orb zu einer 14-px-Bildunterschrift oder zu einem 48-px-Block, ohne dass Sie Stile schreiben. Die Prop paused friert die Animation im aktuellen Bild ein, und className lässt den Orb die Textfarbe Ihrer Utility-Klassen übernehmen. Gezeichnet wird in currentColor, der Dunkelmodus funktioniert also ohne Zusatz.

Optionale Formen und Renderer

Der Kern liefert eine Form und einen Renderer. Vier weitere Formen (cube, octahedron, tetrahedron, torus) und sieben Renderer (dashes, squares, crosses, mesh, halftone, lines, verticalLines) liegen in eigenen Einstiegspunkten. Tree Shaking lässt weg, was Sie nicht importieren, und eine eigene Form ist eine Funktion, die Punkte innerhalb der Einheitskugel zurückgibt.

Vier Wege zur Integration

Sie können aus npm installieren, den Code über eine shadcn-URL kopieren, ihn in reinem JavaScript mit mountOrb einhängen oder das Swift-Paket in Xcode hinzufügen. Die Vanilla-Version bietet pause, play und destroy, was zu einer Seite passt, die ihren Lebenszyklus selbst verwaltet. Die SwiftUI-Version zeichnet im Vordergrundstil, ein Modifier wie foregroundStyle(.blue) färbt sie also ein.

Geringes Gewicht und Barrierefreiheit ab Werk

Der React-Build hat außer React keine Abhängigkeiten, der Vanilla-Build gar keine. Die Standardgröße von 20 px ist die Größe, für die die Formen gezeichnet wurden, die Punkte bleiben also in einer dichten Oberfläche lesbar. Die Prop label benennt den Orb für Screenreader, und bei reduzierter Bewegung im System hält die Animation an.

Open Source unter der MIT-Lizenz

Der vollständige Code liegt auf GitHub, und die MIT-Lizenz erlaubt kommerzielle Nutzung, Änderung und Weitergabe. Zahlen läuft freiwillig über Patreon und finanziert die Arbeit, ohne Funktionen freizuschalten. Für ein Team, das die Komponente forken und selbst pflegen will, bleibt der Aufwand kalkulierbar.

Vor- und Nachteile

Vorteile

  • Neun Zustände mit Varianten decken fast alle Aktionen ab, die eine Agenten-Oberfläche melden muss.
  • Keine Abhängigkeitskette, die Installation belastet ein React-Projekt kaum.
  • Die Standardgröße von 20 px bleibt in Werkzeugleisten, Nachrichtenkopf und Seitenpanel gut lesbar.
  • Reduzierte Bewegung und die Beschriftung für Screenreader stecken bereits in der Komponente.

Nachteile

  • Der Orb animiert nur, Sie müssen die Ereignisse Ihres Agenten also selbst dem richtigen Zustand zuordnen.
  • Formen und Renderer gibt es nur im Web, die SwiftUI-Version bleibt dadurch schmaler.
  • Die Dokumentation passt auf eine Seite, für das Timing zwischen Zuständen hilft nur Ausprobieren.

Häufige Fragen

Ja. Das Paket ist Open Source unter der MIT-Lizenz, alle Zustände, Formen und Renderer sind ohne Kosten enthalten. Es gibt keine Bezahlstufe und kein Konto.