BOB – Bring Your Own Brain

Ihr KI-Coding-Agent in VS Code – mit dem Modell Ihrer Wahl.

BOB arbeitet mit Azure AI Foundry, Azure OpenAI, jedem OpenAI-kompatiblen Endpoint oder einem lokalen Modell über Ollama, LM Studio oder vLLM. Sie entscheiden, wohin Ihr Code geht.

Beschreiben Sie einfach, was erledigt werden soll. BOB liest Ihr Projekt, ändert Code, führt Tests im Terminal aus und zeigt Ihnen jede Dateiänderung im Diff. Riskante Schritte laufen standardmäßig erst nach Ihrer Freigabe.

Warum BOB?

Ihr Modell, Ihre Regeln. Cloud-Modell im eigenen Azure-Tenant oder lokales Modell auf Ihrem Rechner: Sie legen beliebig viele Modellprofile an und wechseln direkt im Chat. BOB enthält keine eigene Telemetrie und spricht nur mit Diensten, die Sie selbst einrichten.

Ein Agent, der wirklich mitarbeitet. BOB arbeitet direkt in Ihrem Workspace: Dateien lesen und bearbeiten, Befehle im Terminal ausführen, Fehlern nachgehen, Tests laufen lassen. Größere Aufgaben zerlegt BOB in eine Aufgabenliste und verteilt Teilaufgaben an Sub-Agents.

Sie behalten die Kontrolle. Dateiänderungen prüfen Sie im Diff und übernehmen oder verwerfen sie. Vor riskanten Terminalbefehlen, Commits, Pushes und Änderungen an Ihren Backlogs fragt BOB standardmäßig nach. Mit Stop brechen Sie jederzeit ab.

Von der Idee bis zum Commit. Im Product Planning entsteht aus einer Idee ein geprüfter Backlog in GitHub, GitLab, Azure DevOps, Gitea oder Obsidian. Der DevOps Agent setzt einzelne Work Items um, protokolliert Tests und bereitet Commit und Push vor.

Offen für Ihre Werkzeuge. MCP-Server, Obsidian-Vaults als Wissensbasis, Websuche und die Language-Model-Tools anderer Extensions lassen sich einbinden.

In wenigen Minuten startklar

1. BOB öffnen: In der Aktivitätsleiste auf das BOB-Symbol klicken.
2. Modell verbinden: Im Chat das Zahnrad öffnen, unter Models auf + Add Model klicken, Endpoint, Modell und Authentifizierung eintragen und mit Test Connection prüfen.
3. Loslegen: Modus wählen, Aufgabe beschreiben, senden.

Beispiel für ein lokales Modell mit Ollama:

API-Schlüssel speichert BOB im VS Code Secret Storage, nie in den Settings.

Voraussetzung: VS Code 1.108 oder neuer.

Der passende Modus für jede Aufgabe

Agent Teams gibt es fertig für Server Administration, Data Engineering Platform, Web Product Delivery und Research & Content Delivery. Eigene Teams lassen sich konfigurieren; das Routing zwischen den Mitgliedern erfolgt per Regeln, per Modell oder kombiniert (hybrid, Standard).

Weitere Helfer:

• Sub-Agents erledigen Teilaufgaben isoliert, mit Zeit-, Runden- und Tiefenlimit.
• Prompt Delegation übergibt eine Teilaufgabe an ein anderes Systemprompt-Profil mit eingeschränktem Werkzeugsatz.
• Review Agents prüfen auf Wunsch ausstehende Dateiänderungen oder den ganzen Workspace (BOB: Review Workspace).

Sicherheit und Kontrolle

• Freigaben: bob.agent.permissionsMode legt fest, wann BOB fragt.

  • default: Dateiänderungen und riskante Terminalbefehle werden bestätigt (einzeln abschaltbar).
  • ask-destructive: Vor riskanten Terminalbefehlen fragt BOB immer.
  • bypass: BOB führt alle Werkzeuge ohne Rückfrage aus, auch solche aus bob.tools.disabledTools. Nur für vertrauenswürdige, isolierte Umgebungen.

• Dateiänderungen: bob.workspace.confirmFileChanges fragt vor dem Schreiben, Bearbeiten und Löschen. Jede Änderung über BOBs Dateiwerkzeuge erscheint im Diff und lässt sich rückgängig machen. Ob Terminalbefehle Projektdateien ändern dürfen, steuert bob.workspace.fileMutationPolicy (vscode-only, ask-terminal, unrestricted); Build-Ausgabeordner aus bob.workspace.generatedOutputPaths sind ausgenommen.

• Terminal: Jeder Befehl läuft genau einmal. Fehlt die Ausgabe, meldet BOB das, statt den Befehl zu wiederholen. bob.agent.destructiveToolCallLimit begrenzt ändernde Aufrufe pro Durchlauf.

• Backlog und Git: Planfreigabe, Anlegen von Backlog-Einträgen, Abschluss von Aufgaben, Fortschritts-Sync, Branchwechsel, Pull Requests, Commit und Push brauchen außerhalb von bypass Ihre Bestätigung in einem Dialog, der das konkrete Ziel zeigt. Das Modell kann sich diese Freigaben nicht selbst erteilen.

• MCP-Vertrauen: Bevor BOB einen MCP-Server startet oder verbindet, fragt es nach, wenn der Server

  • einen lokalen Prozess startet (stdio),
  • aus dem Workspace stammt oder von einer Extension gefunden wurde,
  • ein eigenes Arbeitsverzeichnis nutzt oder
  • zugangsdatenähnliche Umgebungsvariablen setzt.

  Die Entscheidung gilt pro Workspace und Konfiguration. Ändert sich die Konfiguration, fragt BOB erneut.

• Zugangsdaten: Modell-API-Schlüssel, Planning-Tokens und der Websuche-Schlüssel liegen im VS Code Secret Storage. In gespeicherten Sessions maskiert BOB Bearer- und Basic-Auth-Daten, sk-…-Schlüssel, GitHub-Tokens sowie Werte von Feldern wie password, token oder apiKey und von CLI-Flags wie --token.

Funktionen im Überblick

Kontext, Sessions und Gedächtnis

• Kontextbudget: Die Anzeige im Chat und BOB: Show Context zeigen geschätzte Tokens für System, Nachrichten, Tool-Ergebnisse und Tool-Schemas. Ab bob.contextWindow.autoSummarizeThreshold (Standard 0,7) fasst BOB ältere Nachrichten zusammen; große, ältere Tool-Ergebnisse werden gekürzt.
• Kontext zurücksetzen: Frühere Abschnitte bleiben sichtbar, werden aber nicht mehr an das Modell gesendet.
• Sessions: Unterhaltungen bleiben über Neustarts erhalten (bob.sessions.enabled, Aufbewahrung bob.sessions.maxAgeDays, Standard 30 Tage).
• Workspace Memory: Der Ordner .bob/ enthält MEMORY.md, CONVENTIONS.md, ARCHITECTURE.md, TOOLS.md, TASKS.md sowie Tageslogs. BOB nutzt diese Inhalte als Projektwissen; BOB: Continue Tasks setzt offene Einträge fort.
• Anhänge: Dateien per BOB: Attach to Chat oder Drag & Drop anhängen, bis 20 MB pro Datei. Unterstützt werden Code und Text, Bilder (bei Vision-Modellen) sowie PDF, DOCX, XLSX, PPTX, ODT, ODS und ODP. Gescannte PDFs werden als Seitenbilder übergeben.

Modelle und Provider

Ein Modellprofil (bob.models) beschreibt einen Endpoint; das aktive Profil steht in bob.activeModel.

Mit apiType: auto nutzt BOB die Anthropic Messages API, wenn der Pfad /anthropic enthält oder der Modellname auf Claude hinweist; sonst Chat Completions bzw. die Responses API.

Proxy: bob.proxy.autoFallback prüft, ob der konfigurierte Proxy erreichbar ist, und verbindet bei Ausfall direkt (standardmäßig aus).

Integrationen

• MCP-Client (standardmäßig an): Server aus bob.mcpServers, aus .vscode/mcp.json und aus MCP-Providern installierter Extensions. Transporte: stdio, http und sse; HTTP-Header wie Authorization lassen sich über headers setzen.
• Mitgelieferter MCP-Server: Stellt Befehls- und Dateiwerkzeuge für andere KI-Clients in VS Code bereit. Pfade sind auf den Workspace beschränkt; destruktive Befehle, Shells und Befehlssubstitution sind gesperrt. Eine strikte Befehls-Allowlist aktivieren Sie über bob.mcp.allowedCommands.
• Obsidian (standardmäßig aus): Vault-Profile pro Session, gepinnte Notizen und Präferenznotizen als Kontext, Agent Skills unter Skills/<name>/SKILL.md, Schreibzugriffe auf Wunsch auf einen Unterordner beschränkt.
• Websuche (standardmäßig aus): DuckDuckGo, Brave, Jina oder SearXNG.
• Product Planning: Backlogs in github, gitlab, azureDevOps, gitea oder einem lokalen obsidian-Vault. Ein Plan wird erst nach Vorschau, Readiness-Prüfung, Probelauf und Ihrer Freigabe angelegt. Der agentische Workflow bob.planning.agentic.enabled ist experimentell und standardmäßig aus.
• DevOps Agent: Work Items suchen, mit freigegebenem Ausführungsplan umsetzen, geänderte Dateien und Testläufe protokollieren, daraus einen Commit-Vorschlag erstellen. Ein Commit umfasst nur die Dateien aus dem Vorschlag.

Werkzeuge

Die BOB-Werkzeuge stehen zusätzlich als VS Code Language-Model-Tools (bob_*) zur Verfügung.

Mit bob.tools.selectionMode steuern Sie, welche Werkzeuge das Modell erhält:

• all (Standard): alle freigegebenen Werkzeuge.
• auto: zunächst eine aufgabenbezogene Auswahl; weitere Werkzeuge lädt das Modell bei Bedarf über discover_tools nach. Spart Kontext bei kleinen Modellen.

In bob.tools.disabledTools gesperrte Werkzeuge werden außerhalb des Modus bypass nie angeboten und nie ausgeführt, auch nicht von Sub-Agents.

Befehle

Lokale Metrics

Das Diagramm-Symbol Metrics neben den Session-Einstellungen in der BOB-Sidebar öffnet die Übersicht im Editor. Alternativ verwenden Sie BOB: Show Metrics. Die Ansicht bietet Overview, Models, Tasks, History, Export und Settings. Die Aufnahme aktivieren Sie dort ausdrücklich; das Öffnen schaltet sie nicht ein. BOB trennt Nutzeraufträge, logische Modellaufrufe, tatsächliche Request-Versuche und Werkzeuge. Es gibt keine zusätzlichen Modellaufrufe, keine Rangliste und keine automatische Modellwahl.

Metrics speichert ausschließlich erlaubte Metadaten und pseudonyme IDs, keine Prompts, Antworten, Reasoningtexte, Code, Pfade, URLs, Toolargumente/-ausgaben oder Secrets. Die Oberfläche zeigt die aktuell konfigurierten Modell- und Profilnamen über eine rein lokale, flüchtige Zuordnung. Namen werden weder in Metrics-Dateien noch in Exporte übernommen; entfernte oder umbenannte Konfigurationen fallen auf die pseudonymen IDs zurück. Der Speicher liegt im globalen Speicher des jeweiligen Extension-Hosts: bei SSH/Container/WSL also möglicherweise auf dem Remotehost. Es gibt keine externe Telemetrie oder Synchronisation. Standard: 30 Tage, 100 MiB, begrenzte Queue. Pause behält Daten; Delete verlangt eine separate Bestätigung und erneuert die pseudonyme Identität. Bei vollem Speicher oder Schreibfehlern gehen Messdaten verloren, nicht der BOB-Auftrag.

Unbekannte Usage oder Kosten sind unknown, nicht 0. Kosten entstehen nur aus expliziten, versionierten bob.metrics.tariffs; sie referenzieren pseudonyme Profil-/Modell-IDs und verwenden flache Input-/Outputpreise je Million Tokens. Cache-/Reasoning-Anteile werden nicht doppelt gezählt; Währungen bleiben getrennt, Betriebskosten unbekannt. Explizite Nulltarife sind möglich.

Technischer Abschluss, freiwilliges Taskfeedback, Keep/Undo-Patchentscheidungen und Validierung bleiben getrennt. Run Validation Task führt nach Bestätigung eine gewählte VS-Code-Task aus und erfasst deren Exitcode mit Scope und Quelle, ohne Befehle oder Ausgabe zu speichern. Record Validation Result ist dagegen eine bestätigte Nutzerangabe, kein automatisch verifizierter Testnachweis.

Unter Tasks öffnet die Task-ID die Work steps: Planschritte und untergeordnete Toolaktionen mit eigenem Typ, Modell-/Toolbezug, Ausführungszustand und separatem Prüfnachweis. Explizite taskType-Angaben der Aufgabenliste haben Vorrang; andernfalls erfolgt eine lokale, als unsicher gekennzeichnete Heuristik ohne zusätzlichen Modellaufruf. Unterschiedliche Plantypen ergeben mixed. Ein Agentenstatus completed erscheint als Agent-reported done, nicht als geprüfter Erfolg. Die Prüfsymbole je Schritt starten einen bestätigten VS-Code-Prüflauf oder erfassen eine Nutzerangabe nur für diesen Schritt. Auch ein bestandener Schrittprüflauf bestätigt nicht automatisch den gesamten Task oder sämtliche Akzeptanzkriterien. Schritttitel und Befehlsausgaben bleiben außerhalb der Metrics; frühere Aufzeichnungen erhalten keine erfundenen Schritte.

Der bestätigte ZIP-Export enthält Tasks, Arbeitsschritte (steps.csv), Modellaufrufe, Request-Versuche, Werkzeuge, Tarif-Snapshots und einen Markdownbericht. Er ist pseudonym, formelgeschützt und auf 20.000 Zeilen/20 MiB CSV begrenzt. Exportdateien unterliegen weder der Metrics-Retention noch Delete Metrics. Große Queryindizes und unvollständige Aufzeichnungen werden als solche angezeigt. Im aktuellen Extension-Host aktive Tasks sind running; fehlende Endereignisse ohne aktiven lokalen Besitzer werden als incomplete angezeigt, nicht als bewiesener Abbruch. Andere Extension-Hosts werden dabei nicht live abgefragt. Beim Shutdown wird höchstens 1,5 s auf ausstehendes I/O gewartet.

Einstellungen

Alle Einstellungen beginnen mit bob. und sind in den VS Code Settings beschrieben. Die meisten lassen sich auch direkt in den BOB-Einstellungen im Chat ändern. Die wichtigsten Gruppen:

bob.azure.* ist veraltet: BOB liest diese Werte nur noch als Fallback-Profil „Default“, wenn kein Eintrag in bob.models existiert. Einstellungen und Secrets des Vorgängers AI Wingman werden beim ersten Start einmalig übernommen.

Gut zu wissen

• Ihre Daten: Prompts, angehängte Dateien und Tool-Ergebnisse gehen an das Modell, das Sie konfigurieren. Mit einem lokalen Modell verlassen sie Ihre Umgebung nur über Dienste, die Sie zusätzlich einrichten, etwa Websuche, MCP-Server oder Backlog-Provider.
• Token-Angaben sind Schätzungen über die Zeichenzahl, keine Tokenizer- oder Abrechnungswerte.
• Ohne Shell Integration im Terminal läuft ein Befehl einmal als Hintergrundprozess; interaktive Befehle sind dort nicht möglich.
• Der agentische Planning-Workflow ist experimentell. Agent Teams arbeiten sequenziell.
• Die Oberfläche von BOB ist englischsprachig.

Lizenz und Mitwirken

BOB steht unter der MIT-Lizenz. Build, Tests, Qualitätsprüfung und VSIX-Erstellung beschreibt docs/DEVELOPMENT.md im Quellrepository, die Architektur docs/ARCHITECTURE.md. Sicherheitsprobleme melden Sie bitte nicht öffentlich, sondern direkt an den Publisher.

Viel Erfolg mit BOB – bringen Sie Ihr eigenes Modell mit.