Where Am I: Claude Code Sitzungsübersicht über dem Prompt

Where Am I ist ein Community-Mod von Hamza Zafar (hamzafer) und gehört zu seiner Sammlung claude-code-mods. Er hält eine Claude Code Sitzungsübersicht über dem Prompt bereit, damit du nach einer langen Antwort oder einer Pause aufschauen und sehen kannst, wo du stehst. Das Band zeigt das Ziel der Sitzung, was gerade passiert, worauf Claude von dir wartet und den nächsten Schritt. Der Autor hat ihn für Menschen geschrieben, die leicht den Faden verlieren, und der Systemprompt dahinter verlangt einfache Worte.

Das Band hat bis zu drei Zeilen. ◆ Goal: enthält das übergeordnete Ziel, das das Modell beibehalten soll, solange es sich nicht klar ändert. Die Zeile now: folgt Claudes Arbeit live, mit Bezeichnungen wie reading src/index.js, und next: steht in derselben Zeile. Eine gelbe Zeile waiting on you: erscheint nur, wenn Claude etwas von dir braucht. Jedes Feld wird auf einen Satz von höchstens 70 Zeichen gekürzt.

Die Übersicht schreibt ein kleiner Modellaufruf nach jedem Zug. /where schreibt auf Wunsch eine längere: bis zu sechs Stichpunkte aus den letzten 12 Nachrichten der Unterhaltung. Nutzt du mehrere Band-Mods, sortiert sich Where Am I mit ihnen über eine gemeinsame Datei für die Band-Reihenfolge, was die Tests des Autors abdecken.

Die Aufnahme startet Claude Code mit geladenem Mod im kleinen Demo-Projekt und bittet Claude, README.md zu lesen und in einem Satz zu sagen, worum es im Projekt geht. Solange Claude arbeitet, ist das Band über dem Prompt noch leer. Wenn der Zug endet, erscheinen Claudes Antwort und die Zeile done, und wenige Sekunden später die Übersicht über dem Prompt: eine Zeile Goal: über das Verstehen der Demo-App, eine Zeile now:, dass die README gelesen wurde, und eine Zeile next:. Danach endet der Clip mit Ctrl+C.

Nutze eine der Methoden im Installationsblock; sie installieren direkt aus dem eigenen Marketplace des Autors. Das Band erscheint nach deinem ersten abgeschlossenen Zug, und /where wird beim Sitzungsstart registriert.

Die Übersicht liegt in einem vom Host gehaltenen $.state-Atom und übersteht daher einen Hot-Reload. Der Modellaufruf, der sie schreibt, läuft von turn.complete aus und wird nicht abgewartet, sodass der Zug sofort endet. Aus hooks/register.tsx:

on('turn.complete', async ($, e, next) => {
  const r = await next(e)
  if (!e.agentId) {
    await update($, live, () => '')
    void summarize($, prompt, log, e.answer).catch(() => {}) // in the background, so the turn ends at once
  }
  return r
})

summarize ruft $.model.complete mit dem Modell haiku auf. Gesendet werden die vorige Übersicht, deine letzte Nachricht (die ersten 1500 Zeichen), die Bezeichnungen der Tool-Aufrufe dieses Zuges und die ersten 2500 Zeichen von Claudes Antwort; verlangt wird JSON mit goal, now, waiting und next. parseRecap akzeptiert einen Codeblock um das JSON, kürzt die Felder und ersetzt Gedankenstriche. Ein tool.call-Hook schreibt die Bezeichnung für now und behält die letzten 20 Bezeichnungen für die nächste Übersicht; er beobachtet nur und gibt den Aufruf unverändert zurück. Züge von Subagenten werden übersprungen, Aufrufe anderer Mods werden über next.origin erkannt und ignoriert. Das Band wird an der Render-Stelle AbovePrompt gezeichnet und verschwindet, solange eine Umfrage offen ist.

In /config gibt es keine Optionen, /where ist der einzige Befehl. Zum Ändern bearbeitest du register.tsx: MODEL wählt das Modell für die Übersicht, MAX_LOG legt fest, wie viele Bezeichnungen von Tool-Aufrufen gespeichert werden, clip setzt die Grenze von 70 Zeichen, und die zwei Systemprompts in summarize und longRecap bestimmen den Ton. Die Position des Bandes unter anderen Band-Mods wird einmal pro Sitzung aus bands.json im Konfigurationsordner gelesen, starte Claude Code also neu, um eine Änderung zu übernehmen.

Bevor etwas lief, haben wir jede Datei gelesen, die das Plugin ausführen kann: hooks/hooks.json, hooks/register.tsx, hooks/bands.ts, die Typdeklarationen und die Tests. Es gibt keine package.json, kein Installationsskript, keine Binärdatei und keinen gebündelten Code, und wir fanden keine versteckten Zeichen, kein eval und keine dynamischen Importe. Die MIT-Lizenz liegt im Wurzelverzeichnis des Repositorys.

• Modellaufrufe. $.model.complete läuft nach jedem Zug des Hauptagenten und bei /where. Es sendet deinen Prompt, die Tool-Bezeichnungen und Claudes Antwort (bei /where die letzten 12 Nachrichten) über Claude Code an das Modell haiku und verbraucht damit dein Kontingent oder deine API-Nutzung. Der Mod selbst hat keinen Netzwerkcode, und an andere Hosts wird nichts gesendet.
• Umgebung und Dateien. Er liest CLAUDE_CONFIG_DIR und HOME und, falls vorhanden, eine Datei, <config dir>/claude-code-mods/bands.json, für die Reihenfolge der Bänder. Er schreibt keine Dateien; die Übersicht liegt in $.state.
• Hooks. prompt.submit und tool.call beobachten nur und reichen alles unverändert weiter; validate vermerkt, dass beiden ein .catch fehlt. Der Mod blockiert oder ändert nichts. Er fügt /where hinzu und verändert die Oberfläche über dem Prompt.
• Nicht vorhanden. Keine Prozesse, Shell-Befehle, Daemons, Telemetrie, Geheimnisse oder Änderungen an Einstellungen und keine Anweisungen an das Modell außer den zwei Prompts für die Übersicht.

claude plugin validate meldete weder Fehler noch Warnungen, und die 7 Tests des Autors bestanden mit claude plugin test unter Claude Code 2.1.303.

Geprüft mit Claude Code 2.1.303 unter macOS (validate, Tests und eine Aufnahme). Wenn das Band nicht erscheint:

• Schließe zuerst einen Zug ab; die Übersicht wird danach geschrieben, und eine fehlgeschlagene oder nicht lesbare Modellantwort lässt das Band leer.
• Eine offene Umfrage über der Eingabe blendet es aus, bis sie geschlossen wird.
• Ist /where unbekannt, hat Claude Code bereits einen Befehl mit diesem Namen, und der Mod startet ohne ihn.
• Meldet /where „Could not build a recap right now“, blieb der Modellaufruf unbeantwortet; versuche es erneut.

Das Band liest den Zustand von next-steps und blendet deshalb seinen eigenen Teil next aus, wenn dieser Mod seine Liste zeigt.