Fasse den Diff zusammen, lies Risiko und leite Verifikation direkt aus betroffenen Packages ab.
gosherpa pr --base main RISK medium AFFECTED ./internal/sherpa VERIFY go test ./internal/sherpa
Agent-first Code-Intelligenz für Go-Repositories
GoSherpa
Gib einem Coding Agent eine Repository-Frage. GoSherpa liefert eine kleine, verlässliche Karte: Readiness, Symbole, Referenzen, Call-Pfade, Impact, Tests und begrenzten JSON-Kontext direkt aus deinem Go-Repository.
- Symbol-Lookup
- Referenzen
- Caller & Callees
- Impact
- PR-Kontext
- Agent Workflow
Warum GoSherpa
Wenn der Code zum Gebirge wird, zeigt GoSherpa die Route.
GoSherpa liest dein Go-Projekt strukturell statt magisch. Die CLI gibt Coding Agents eine deterministische Arbeitskarte und bleibt dabei für Menschen im Terminal gut lesbar.
- Wo ist das definiert? Symbol, Datei, Signatur und Zeilennummer.
- Wer benutzt das? Referenzen, direkte Caller und relevante Tests.
- Was ruft diese Funktion auf? Callees und lokale Call-Pfade durch dein Repository.
- Was betrifft mein Diff? Betroffene Packages, Risiko und sinnvolle Testbefehle.
Sofort ausprobieren
Ein kleiner Install-Flow, dann echte Repository-Antworten.
GoSherpa soll sich wie ein normales Go-Tool anfühlen: lokal installieren, Readiness prüfen, Snapshot erzeugen und den Agent mit begrenztem Diff-Kontext starten.
go install github.com/panndabea/GoSherpa/cmd/gosherpa@latest gosherpa init --base HEAD gosherpa doctor --json gosherpa agent context --json
Lokal, kein Code-Upload
MIT-Lizenz
Go 1.24.4
Stabile JSON-Umschläge
Go-Tests + Golden Fixtures
Wofür du es nutzt
GoSherpa beantwortet Arbeitsfragen, nicht nur Feature-Listen.
Die besten Einstiege sind konkrete Situationen: Agent-Review, Onboarding, Symbolarbeit und fokussierter Drill-down.
Starte mit Architektur, Hotspots und Symbolinventar, ohne dich erst durch alle Ordner zu klicken.
gosherpa analyze . gosherpa architecture gosherpa risk
Finde Definition, Referenzen, Caller, Callees, relevante Tests und eine sinnvolle Lesereihenfolge.
gosherpa explain ParseFile gosherpa refs ParseFile --kind call gosherpa tests ParseFile
Gib Codex, Claude Code oder Cursor eine begrenzte, repository-geerdete Arbeitskarte statt ein ganzes Repository in den Prompt zu kippen.
gosherpa agent context --base HEAD \ --use-snapshot \ --max-files 20 --max-symbols 40 \ --max-tests 20 --max-bytes 12000 \ --json
Frag GoSherpa
Klicke auf eine Frage. Sieh die Antwort im Terminal.
Die Demo zeigt typische Workflows als kompakte CLI-Ausgaben: verstehen, Kontext holen, Impact prüfen und Tests planen.
gosherpa explain ParseFile
Agentische Workflows
Gebaut für agentische Workflows.
GoSherpa liefert den agent-first Einstieg in ein Go-Repository. AI Coding Agents prüfen Readiness, Grenzen, Impact, Tests und nächste Befehle, bevor sie Code ändern.
Agent Guide
Ein klarer Startpunkt für Coding Agents.
Die Kurzfassung: erst Readiness prüfen, dann begrenzten Kontext holen, Impact verstehen und Tests planen, bevor ein Agent Code ändert.
Vollständigen Guide auf GitHub lesen-
Readiness prüfen
Go-Umgebung, Modul, Snapshot und Analyse-Vertrauen vor der Arbeit sichtbar machen.
gosherpa init --base HEAD -
Kontext begrenzen
Mit agent context nur die Dateien, Symbole, Tests und Quell-Auszüge laden, die für den aktuellen Diff zählen.
gosherpa agent context --json -
Impact lesen
Betroffene Packages, geänderte Symbole und mögliche Caller-Ketten prüfen.
gosherpa impact diff --base HEAD --json -
Tests planen
Sinnvolle Testbefehle aus dem Diff ableiten, statt blind alles oder gar nichts zu starten.
gosherpa tests affected --json
Copy-Paste-Startpaket für Agents
Diese Sequenz reicht für viele Review-, Repair- und Edit-Aufgaben: erst Vertrauen prüfen, dann den agent-first Diff-Kontext laden.
gosherpa init --base HEAD gosherpa doctor --json gosherpa agent context --json gosherpa tests affected --json
Comic-Guides
Drei Situationen, in denen GoSherpa sofort hilft.
Die Bilder erzählen die Geschichte, die CLI liefert die Details.
Symbole finden
Vom Namen zur Definition: GoSherpa zeigt dir Signatur, Package, Datei, Dokumentation und passende Treffer, ohne dass du das Projekt durchklicken musst.
gosherpa symbol ParseFile
Impact einschätzen
Ein kleiner Change kann mehrere Routen berühren. GoSherpa zeigt betroffene Packages, geänderte Symbole, Risiko und die Tests, die jetzt wirklich zählen.
gosherpa impact diff --base HEAD
Kontext weitergeben
Agent-first, für Menschen lesbar: GoSherpa exportiert Source-Auszüge, Beziehungen, Tests, Grenzen und JSON in einer kompakten Form.
gosherpa agent context --json
Was die Software kann
Konkrete Antworten statt Code-Nebel.
GoSherpa ist bewusst als agent-first CLI gebaut: ein Daily-Driver für Coding Agents, kleine fokussierte Befehle für Drill-downs und klare Terminalausgaben für Menschen.
Symbolatlas
Listet und filtert Structs, Interfaces, Funktionen und Methoden im Projekt.
gosherpa symbols --kind function
Suche & Referenzen
Findet partial Matches und Go-bewusste Referenzen, optional nach Art gefiltert.
gosherpa refs ParseFile --kind call
Call-Beziehungen
Zeigt direkte Caller, Callees und kurze lokale Pfade zwischen Funktionen.
gosherpa path Run ParseFile
Interfaces & Verträge
Zeigt Methoden, Implementer, Typ-Referenzen und sichtbare Interface-Methodennutzung.
gosherpa interface UserRepository
PR-Intelligenz
Fasst Diffs zusammen und nennt Risiko, betroffene Bereiche und Verifikation.
gosherpa pr
Agent-Kontext
Exportiert deterministische Kontextpakete mit Limits für Codex, Claude Code, Cursor und CI.
gosherpa agent context --json
Warum man GoSherpa vertrauen kann
GoSherpa bleibt nah an Go und ehrlich über Grenzen.
Das Projekt soll nachvollziehbar sein: lokale Analyse, dokumentierte JSON-Verträge, Tests, Roadmap und explizite Confidence statt stiller Vermutungen.
GoSherpa liest dein Repository auf deiner Maschine und braucht keinen SaaS-Upload.
Analyse über Go-AST, Module, Packages, Imports und typisierte Daten, wo verfügbar.
JSON-Schema, Context-Schema und stabile Response-Envelopes machen Automatisierung greifbar.
Outputs nennen Warnings, Analyse-Modi, Confidence und bekannte MVP-Limitationen.
Tool
Gut für
GoSherpa ergänzt durch
rg / grep
schnelle Textsuche
Go-bewusste Symbole, Referenzen und Packages
gopls / IDE
interaktive Navigation
terminalfähige Reports und JSON für Agents
CI
Tests ausführen
betroffene Tests und Verifikationsbefehle vorschlagen
Coding Agent
Code lesen und ändern
begrenzten, repository-geerdeten Kontext liefern
Für die Go Community
Was das Projekt für Go-Leute spannend macht.
GoSherpa verkauft keine Magie. Es macht Go-Code strukturell lesbarer: lokal, terminalfreundlich, mit ehrlichen Grenzen und Ausgaben, die sich in Reviews, CI und Agent-Workflows verwenden lassen.
Symbole, Packages, Imports, Interfaces und Referenzen kommen aus Go-AST und go/packages statt aus reinem Textgrep.
go/packages + AST
Kleine Befehle, lesbare Tabellen, stabile Exit Codes und JSON für Automatisierung.
gosherpa explain ParseFile
PR-Zusammenfassungen, Diff-Impact und betroffene Tests helfen beim Review, ohne das Projekt komplett neu zu laden.
gosherpa pr --base HEAD
Outputs zeigen Confidence, Warnungen, Analyse-Modi und bekannte Limitationen, statt Gewissheit vorzutäuschen.
confidence + warnings
MIT-Lizenz, Roadmap, Status-Dokumente, Go-Tests und Golden-JSON-Fixtures machen Beiträge nachvollziehbar.
go test ./...
Mitbauen
Ein guter Einstieg für Contributors.
Hilfreich sind gerade Beispiel-Repositories, bessere semantische Analyse, CI-Workflows, Dokumentation und kleine UX-Verbesserungen an CLI-Ausgaben.
Agent-first, menschenlesbar
Ein gemeinsamer Blick auf dieselbe Repository-Intelligenz.
GoSherpa versucht nicht, deine IDE zu ersetzen. Es macht die Struktur deiner Codebasis als Agent-Kontext sichtbar, damit Mensch und Agent beim Lesen, Ändern und Reviewen weniger raten müssen.
Entwickler
Schneller verstehen, wo etwas lebt, wer es benutzt und wie groß der nächste Schritt wirklich ist.
Review
PR-Zusammenfassungen, betroffene Tests und Risiko-Hinweise direkt aus dem Diff.
Automation
Stabile JSON-Umschläge und begrenzte Kontextbefehle für Scripts, CI und Coding Agents.
# Analyse-Vertrauen prüfen gosherpa init --base HEAD gosherpa doctor --json # Agent-Workflow-Kontext gosherpa agent context --json # Impact und Testplanung gosherpa impact diff --base HEAD --json gosherpa tests affected --json
Ausprobieren
Starte lokal in wenigen Befehlen.
GoSherpa ist ein frühes MVP, aber die Grundroute steht: Readiness prüfen, Agent-Kontext holen, fokussiert nachlesen und die passenden Tests planen. Für größere Workflows führt dich das README weiter.
go install github.com/panndabea/GoSherpa/cmd/gosherpa@latest gosherpa init --base HEAD gosherpa doctor --json gosherpa agent context --json