das Token-sparende Plugin für Terminal-KI-Agenten

Claude Code · Codex CLI · opencode · Gemini CLI · Claude Desktop · jeder MCP-Client

Ihr Agent verbrennt die meisten Tokens, bevor er auch nur eine Zeile Code schreibt. promptopt stopft die Lecks – lokal, offline, kostenlos.

⚡ Kurzfassung

npx promptopt install        # one command. every detected CLI. done.

Dieser eine Befehl registriert einen MCP-Server, injiziert ein Disziplinprotokoll mit ~200 Tokens, fügt Subagenten mit günstigen Modellen hinzu und beginnt, Ihre Ersparnisse in einem stilvollen HTML-Dashboard zu verfolgen.

Checkboxen lieber? Die Installation über npm (npm i promptopt) oder der Aufruf von promptopt init öffnet eine interaktive Checkliste – Pfeiltasten zum Navigieren, Leertaste zum Umschalten der gewünschten CLIs, a zum Auswählen aller, Eingabetaste zum Konfigurieren:

promptopt - select the CLIs to configure:
  [x] claude
  > [ ] claude-desktop
  [x] codex
  [ ] opencode
  [ ] gemini
  [ ] generic
  space: toggle   a: check all   enter: continue   esc: cancel

Sie erscheint nur bei echten interaktiven Installationen – nie in CI, nie bei npx-Läufen, nie in diesem Repository selbst (PROMPTOPT_NO_INIT=1 deaktiviert sie dauerhaft).

$ promptopt "Hey, could you please fix the bug in src/app.ts? Thanks!"

tokens: 15 -> 7 compressed (net -53.3%)
intent: fix (85% confidence)

--- optimized prompt ---
Fix the bug in src/app.ts

route: simple · gemini-2.5-flash ~$0.0032  (92% under flagship pricing)

Related MCP server: token-compressor

🩸 Das Problem

Bei drei echten Prompts gab promptopt 0,078 $ aus, wo das unkomprimierte Flaggschiff 0,300 $ ausgegeben hätte – live im eigenen Bericht verfolgt.

📦 Installation

Voraussetzung: Node ≥ 18. Keine API-Schlüssel. Keine Konten. Nichts verlässt Ihren Rechner.

Ein Befehl für alles

npx promptopt install
# or the interactive checklist, anytime:
npx promptopt init

Erkennt automatisch, welche CLIs Sie installiert haben, und konfiguriert jede davon. Fügen Sie -n für eine Vorschau hinzu (--dry-run), --all, um alle Ziele zu erzwingen.

Wählen Sie Ihr Ziel

npx promptopt install claude

Registriert den MCP-Server in .mcp.json (Projekt) oder ~/.claude.json (--user-Flag), injiziert das Protokoll in CLAUDE.md und erstellt zwei echte Subagenten:

• promptopt-scout → haiku – schreibgeschützte Lookups & Suchen, Antworten mit ≤5 Zeilen

• promptopt-worker → sonnet – klar abgegrenzte Änderungen, Diff-zuerst-Ausgabe

Starten Sie Ihre Claude-Code-Sitzung neu → fertig.

Hinweis: Projektweite MCP-Server benötigen eine einmalige Vertrauensfreigabe – starten Sie claude im Ordner und akzeptieren Sie die Eingabeaufforderung (oder führen Sie /mcp aus). Hängen Sie bei „Ausstehende Genehmigung“ fest? Genau das ist es. Installieren Sie stattdessen mit --user, und es wird in jedem Projekt ohne Rückfragen vertraut.

Claude Desktop hat kein URL-Schema für lokale Server, also wählen Sie eine der folgenden Optionen:

Option A – Ein-Klick-Bundle (empfohlen): Laden Sie promptopt-<version>.mcpb von Releases herunter und ziehen Sie es auf das Claude-Desktop-Fenster. Alle Abhängigkeiten sind gebündelt – auf der anderen Seite ist kein Node-Tooling erforderlich.

Option B – Installationsprogramm:

npx promptopt install claude-desktop     # writes claude_desktop_config.json for you

Option C – manuell: Fügen Sie es in %APPDATA%\Claude\claude_desktop_config.json (Windows) oder ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ein:

{
  "mcpServers": {
    "promptopt": { "command": "npx", "args": ["-y", "promptopt", "mcp"] }
  }
}

Starten Sie Claude Desktop neu → die Tools erscheinen in Ihren Chats.

npx promptopt install codex --user    # ~/.codex/config.toml + ~/.codex/AGENTS.md
npx promptopt install codex           # project AGENTS.md only

npx promptopt install opencode   # opencode.json + AGENTS.md
npx promptopt install gemini     # .gemini/settings.json + GEMINI.md
npx promptopt install generic    # any MCP client: AGENTS.md + printed snippet

Überprüfen & rückgängig machen

npx promptopt doctor       # health-check every registration
npx promptopt uninstall    # removes everything cleanly (marker-based, zero residue)

Alle Änderungen an Anweisungsdateien befinden sich zwischen <!-- promptopt:start vX -->- und <!-- promptopt:end -->-Markierungen; JSON-Konfigurationen erhalten .bak-Sicherungen, bevor sie angefasst werden.

🧠 Wie es denkt

Wird einmal pro Sitzung injiziert (~200 Tokens) – die günstigste Versicherung, die Sie je kaufen werden:

1. Knapp denken. Planen Sie in ≤3 kurzen Sätzen, bevor Sie handeln. Wiederholen Sie die Aufgabe nie. 2. Fragen oder annehmen. Wenn eine Anfrage ≥2 Interpretationen hat: Nehmen Sie die Annahme an und sagen Sie „Angenommen X“ in einer Zeile – es sei denn, eine falsche Vermutung erzwingt eine komplette Überarbeitung, dann stellen Sie ≤3 gebündelte Fragen und hören Sie auf. 3. Günstig routen. Triviale Teilaufgaben gehen an promptopt-scout. Geben Sie niemals Frontier-Tokens für Arbeiten auf Grep-Niveau aus. 4. Stapeln. Parallele Tool-Aufrufe. Lesen Sie jede Datei einmal. Lesen Sie unveränderte Dateien nie erneut. 5. Schlanke Ausgabe. Diffs statt vollständiger Dateien. Aufhören, wenn fertig – keine Zusammenfassung. 6. Große Aufgaben. Führen Sie bei Arbeiten mit >5.000 Ausgabetokens optimize_prompt aus und folgen Sie dessen Plan.

❓ Fragen, die sich selbst beantworten

Jeder Prompt wird nach Absicht klassifiziert (Frage / Bauen / Planen / Beheben / Hinzufügen), und vage Bauaufträge erhalten Multiple-Choice-Menüs statt Freitextaufforderungen:

questions (1) - ask these before acting:
  1. What should be built?
     choices: feature inside the existing app | standalone script | CLI tool |
              library / package | service / API endpoint | full new app
     default if unanswered: a feature integrated into the existing project

Drei Modi: hybrid (Standard – bei ≥70 % Sicherheit annehmen, sonst fragen) · auto (alles annehmen) · ask (nie annehmen).

🛠️ MCP-Tools

💸 Modell-Routing

Preise geprüft gegen das öffentliche LiteLLM-Register am 21.08.2026. Preise ändern sich – legen Sie Ihre aktuellen fest:

promptopt models --refresh   # re-syncs into ~/.promptopt/models.json (trusted 7 days)

Die Absicht steuert die Stufe: question stuft herab (Erklärungen brauchen selten Opus), plan stuft auf mindestens Standard hoch (falsche Pläne sind der teuerste Fehler).

📊 Nutzungsberichte

Jeder Optimierungslauf schreibt in ./promptopt-report/ und gibt den Pfad aus:

report: C:\dev\myproject\promptopt-report\index.html

Ein Dashboard mit dunklem Verlauf, ohne JavaScript, offline nutzbar, mit Statistik-Karten und Fortschrittsbalken:

• gespeicherte Tokens – dieser Lauf und kumuliert

• geschätzte eingesparte Dollar im Vergleich zur Immer-Flaggschiff-Baseline

• verbrauchtes Budget / % übrig (lokales Budget, Standard 10 $)

• der kontrafaktische Balken: was Sie ohne das Plugin verbrannt hätten

• Vorher/Nachher des letzten Laufs, Annahmen, gestellte Auswahlfragen, Routing-Tabelle, letzte 20 Läufe

promptopt budget                       # usage + % left
promptopt budget --set-usd 25 --set-tokens 2000000
promptopt report --open                # print (and open) the static report
promptopt dashboard                    # LIVE dashboard on http://localhost:4739
promptopt "..." --no-report            # optimize without recording

Live-Dashboard

promptopt dashboard startet einen nur-lokalen Server (bindet an 127.0.0.1, nie in Ihrem Netzwerk freigegeben), öffnet automatisch Ihren Browser und hält die Seite live: Ein kleines Poll-Skript erkennt neue Optimierungsläufe und lädt die Seite automatisch neu – lassen Sie sie in einem Tab geöffnet und beobachten Sie, wie die Ersparnisse während der Arbeit wachsen.

promptopt dashboard              # http://localhost:4739
promptopt dashboard -p 8080      # custom port (auto-falls forward if taken)
promptopt dashboard --no-open    # serve without opening the browser

Endpunkte: / (Dashboard), /api/data (Nutzungs-Snapshot als JSON), /api/ping. Die ausgelieferte Seite wird bei jeder Anfrage aus dem Ledger neu gerendert – es gibt keinen Status, der manuell aktualisiert werden müsste.

Fügen Sie promptopt-report/ zu .gitignore hinzu – lokale Telemetrie, nur für Ihre Augen.

⌨️ CLI-Spickzettel

promptopt "<prompt>"                     # optimize (hybrid mode + report)
promptopt init                           # interactive checkbox installer
promptopt "<prompt>" --mode ask          # all questions, zero assumptions
promptopt route "<prompt>"               # tier + cheapest model per provider
promptopt audit "$(cat big-log.txt)"     # token count + compression report
promptopt models                         # catalog + source
promptopt dashboard                      # live localhost usage dashboard
promptopt doctor                         # installation health check

🔒 Datenschutz & Genauigkeit

• Keine Netzwerkaufrufe zur Laufzeit. Das einzige Netzwerkereignis überhaupt ist, dass npm das Paket selbst abruft. Keine Schlüssel, keine Telemetrie, keine Konten.

• Die Komprimierung schützt Codeblöcke, URLs und Dateipfade wörtlich; Anforderungen werden nie verworfen.

• Token-Zählungen verwenden offline cl100k_base BPE – tatsächliche Claude/Gemini-Zählungen weichen um ~±10 % ab. Kosten sind Schätzungen auf Basis öffentlicher Registerpreise, keine Rechnungen.

Claude Desktop akzeptiert Remote-Connectors per URL, aber lokale Stdio-Server – wie promptopt, das vollständig auf Ihrem Rechner läuft – haben kein Deep-Link-Schema. Genau deshalb gibt es das .mcpb-Desktop-Erweiterungsformat: eine Datei, Installation per Doppelklick, Abhängigkeiten inklusive.

🤝 Mitwirken

PRs willkommen – neue Kompressionsregeln, Modellkatalog-Updates, neue Agentenziele. Siehe CONTRIBUTING.md.

git clone https://github.com/hawktuahcoin-hurhur/promptopt && cd promptopt
npm ci && npm run build && npm test && npm run test:smoke

📄 Lizenz

MIT © promptopt-Mitwirkende