Ihr Problem finden
Beginnen Sie mit der Meldung, die Sie in Panolayer sehen. Springen Sie über die Tabelle zur passenden Lösung und prüfen Sie das Ergebnis, bevor Sie den nächsten Schritt versuchen.
| Was läuft schief? | Hier starten |
|---|---|
| Installation oder Systemprüfung wird nicht abgeschlossen | Installation und Systemprüfung |
| Der Browser meldet sich an, die App wartet jedoch weiterhin | Anmeldung abschließen |
| Ihr Repository lässt sich nicht öffnen oder wirkt unvollständig | Richtiges Repository öffnen |
| Ein Agent fehlt, startet nicht oder meldet einen Engine-Fehler | Agent starten |
| Ein Agent kann eine Datei nicht lesen oder ändern | Dateizugriff prüfen |
| Die Verifizierung wird unterbrochen, ist nicht verfügbar oder bleibt unentschieden | Verifizierung wiederherstellen |
| Eine Regel beschreibt das falsche Verhalten | Regel und ihre Belege prüfen |
| Ein Agent stoppt oder seine Änderungen sind nicht auffindbar | Arbeit des Agenten prüfen |
| Ein Graph schlägt fehl oder liefert eine unvollständige Antwort | Graph-Schritt prüfen |
| Ein Merge führt zu Konflikten oder ein Push schlägt fehl | Merge- und Push-Probleme beheben |
| Sie benötigen weiterhin Hilfe | Reproduzierbaren Fehler melden |
Fehler und Arbeitsstand sichern. Notieren Sie die genaue Meldung und wo sie angezeigt wurde. Prüfen Sie den vorhandenen Lauf oder Worktree, bevor Sie eine weitere Aufgabe starten. Sie müssen Ihr Repository, den Agent-Worktree oder Ihre Einstellungen nicht löschen, um dieser Anleitung zu folgen.
Hilfe zur Einrichtung
Warten Sie noch auf die Browser-Anmeldung?
Wählen Sie in Panolayer Browser erneut öffnen und schließen Sie die Freigabe der Anmeldung ab. Wenn die Anfrage abgelaufen ist, wählen Sie Erneut versuchen, um eine neue zu starten.
Verwendet der Browser das falsche Konto?
Wählen Sie auf der Freigabeseite des Browsers Konto wechseln und melden Sie sich dann mit dem gewünschten Konto an.
Ist der Systeminstaller nicht mehr geöffnet?
Wählen Sie auf dem Systemprüfungsbildschirm von Panolayer Installer erneut öffnen und schließen Sie dann die Installation der Apple Command Line Tools ab. Panolayer prüft automatisch, während der Installer läuft.
Bei Problemen mit Installation, Verifizierung oder agent siehe Fehlerbehebung.
Installation oder Systemprüfung wird nicht abgeschlossen
Prüfen Sie zuerst Ihren Mac. Die Panolayer Desktop-App erfordert einen Mac mit Apple Silicon, auf dem macOS 15 Sequoia oder neuer läuft. Prüfen Sie im Apple-Menü → Über diesen Mac Ihren Chip und Ihre macOS-Version. Intel-Macs werden nicht unterstützt.
Wenn Sie Panolayer heruntergeladen, aber nicht installiert haben: Öffnen Sie die .dmg, ziehen Sie Panolayer in Programme und öffnen Sie es anschließend aus dem Ordner Programme. Folgen Sie Panolayer installieren und einrichten für die vollständige Reihenfolge.
Wenn Sie beim Schritt „Ein kurzer Systemcheck“ nicht weiterkommen:
- Wählen Sie Installieren neben Git — Apple Command Line Tools und schließen Sie Apples Installer ab.
- Wenn Sie den Installer geschlossen haben, wählen Sie in Panolayer Installer erneut öffnen.
- Kehren Sie nach der Installation zu Panolayer zurück. Die Tools werden automatisch erkannt; wählen Sie Projekt auswählen, sobald der Systemcheck bereit ist.
Sie können fortfahren, sobald Sie in Panolayer ein Projekt auswählen können. Wenn Apples Installer einen Fehler meldet, geben Sie diese exakte Fehlermeldung an, wenn Sie Hilfe anfordern.
Anmeldung wird nicht abgeschlossen
Die Anmeldung besteht aus zwei Teilen: im Browser authentifizieren, dann diesen Mac für die Panolayer-App bestätigen. Eine angemeldete Website allein schließt die Freigabe der App nicht ab.
| Was du siehst | Was zu tun ist |
|---|---|
| Die App wartet und es ist keine Browserseite geöffnet | Wähle Browser erneut öffnen in Panolayer. |
| Der Browser zeigt ein anderes Konto | Wähle Konto wechseln und melde dich dann mit dem Konto an, das du in der App verwenden möchtest. |
| Der Browser fordert dich auf, diesen Computer zu bestätigen | Vergleiche den angezeigten Code mit dem Code unter Dein Code in der App. Wenn sie übereinstimmen, wähle Ja, auf diesem Computer anmelden. |
| Die Anfrage ist abgelaufen | Wähle Erneut versuchen in Panolayer und schließe die neue Browser-Anfrage ab. |
| Der Browser bestätigt die Freigabe | Kehre zu Panolayer zurück, um die Einrichtung fortzusetzen. |
Verwende in der App und auf der Website dasselbe Konto. Siehe Anmelden für die vollständige Anleitung.
Ein Drittanbieter-agent verlangt eine separate Anmeldung? Das ist die Anmeldung des agent-Anbieters. Dein Panolayer-Konto ersetzt sie nicht. Folge den Anweisungen dieses agents und Unterstützte agents.
Dein Repository lässt sich nicht öffnen oder sieht unvollständig aus
Ihr Projekt lässt sich nicht öffnen?
Prüfen Sie, ob Sie den Stammordner eines lokalen Git-Repositorys ausgewählt haben. Wenn Ihr Repository online gehostet wird, klonen Sie es zuerst auf Ihren Mac und öffnen Sie dann diesen Ordner in Panolayer.
Wählen Sie Projekt öffnen… auf dem Startbildschirm von Panolayer und wählen Sie dann den Stammordner Ihres lokalen Git-Repositorys aus. Eine GitHub-URL ist kein lokaler Ordner; klonen Sie das Repository zuerst mit Ihren üblichen Git-Tools auf Ihren Mac.
Wenn die Karte unvollständig aussieht:
- Prüfen Sie, ob Sie den vorgesehenen Repository-Stamm geöffnet haben und nicht eine einzelne Datei oder den falschen Unterordner.
- Prüfen Sie, ob Panolayer den Code noch analysiert oder einen Indexierungsfehler meldet. Siehe Verifizierung wiederherstellen.
- Prüfen Sie Unterstützte Sprachen für Ihre Codebasis. Untersuchen Sie die in Architektur angezeigten Apps und Beziehungen, insbesondere in einem Monorepo.
Ein erkanntes Framework oder eine sichtbare Datei bedeutet nicht, dass jede dynamische Beziehung aufgelöst werden kann. Siehe Architektur und Abhängigkeiten erkunden.
Vergleichen Sie den Workflow anhand des Beispiels. Die Dokumentation verwendet Twitter Clone, das als twitter-starter geöffnet wird. Ihr eigenes Repository enthält andere Dateien, Issue-Anzahlen und Abhängigkeiten. Sie müssen nicht zum Beispielprojekt wechseln, um Panolayer zu verwenden.
Ein Agent startet nicht
Panolayer Agent ist integriert. Öffnen Sie Meine Agents, wählen Sie die +-Schaltfläche neben Agents überwachen und dann Panolayer Agent aus. Es ist keine separate Anmeldung beim Anbieter erforderlich. Siehe Agent in Ihrem Repository ausführen.
Für einen anderen Agent: Installieren Sie ihn aus dem Marketplace, kehren Sie zu Meine Agents zurück und wählen Sie ihn im selben Menü aus. Schließen Sie bei Aufforderung die Anmeldung beim Anbieter ab. Modellzugriff und Abrechnung liegen beim jeweiligen Anbieter; die passende Einrichtung finden Sie unter Unterstützte Agents.
Wenn eine Agent-Fehlerkarte angezeigt wird:
- Öffnen Sie Technische Details und lesen Sie den Startfehler.
- Wenn die Container-Engine nicht gestartet werden konnte, prüfen Sie die Mac-Anforderungen oben und verwenden Sie dann Wiederholen auf der Fehlerkarte.
- Wenn in der Meldung fehlende Anmeldedaten oder ein Kontoproblem genannt werden, schließen Sie die Anmeldung dieses Agents ab, bevor Sie es erneut versuchen.
- Wenn es mit derselben Meldung erneut fehlschlägt, wählen Sie Fehler melden auf der Fehlerkarte. Dieser Weg enthält die Diagnosedaten des Agents. Prüfen Sie den Bericht, bevor Sie ihn senden.
Ein erfolgreicher Start öffnet die Agent-Unterhaltung, sodass Sie eine Anfrage senden können. Wiederholtes Starten neuer Sitzungen behebt einen unveränderten Installations- oder Kontofehler nicht.
Eine Anfrage wird abgelehnt oder Ihr Nutzungskontingent ist aufgebraucht
Wenn Panolayer die Meldung Ihr Nutzungskontingent für diesen Monat ist aufgebraucht anzeigt, öffnen Sie Einstellungen → Tarif & Nutzung, um Nutzung und Rücksetzdatum des Kontos zu prüfen. Das Wiederholen derselben Anfrage stellt ein aufgebrauchtes Kontingent nicht wieder her.
Prüfen Sie bei einem Agent eines Drittanbieters das in seiner Fehlermeldung genannte Anbieterkonto. Die Anmeldung bei Panolayer ändert das Kontingent oder die Abrechnung dieses Anbieters nicht. Beheben Sie das gemeldete Kontoproblem, bevor Sie es erneut versuchen.
Ein Agent kann eine Datei nicht lesen oder ändern
Check the file’s controls in Architecture. Open the file’s source and scroll down in its details panel.
| Control | What it changes |
|---|---|
| Lock File, under Implementation Lock | Prevents AI agents from modifying the file. |
| Hide from Agents, under Container Agent Access | Prevents new container agents from reading the file. Existing agent sessions are unchanged. |
If the restriction is intentional, keep it and ask the agent to work within it. If you want the agent to access this file, change the relevant control deliberately. A visibility change applies to new container agent sessions; an existing session’s access does not change.
If neither control explains the problem, inspect the agent’s error and the workspace it is using. See Inspect the agent’s work.
Verification has no usable result
Open Issues and read the verification status before deciding what to do. A check that could not finish is not a passing result, and it is different from a rule that failed against your code.
| Status or message | What to do next |
|---|---|
| Analyzing code or Checking rules | Follow the current stage. Wait for it to finish before interpreting the result. |
| Not indexed yet or Couldn’t index this project | Follow the card’s action to start indexing or Retry. Panolayer needs to read the sources before it can verify them. |
| Verification was interrupted or Verification needs attention | Read the accompanying error, address its cause, then choose Retry on the status card. |
| Couldn’t read verification status | Choose Retry to read the status again. The message does not establish whether the code passed or failed. |
| Undecided results | Open the recorded reason for each item. These checks are neither passing nor failing. |
| Input too large | Retrying unchanged inputs will not help. Include the affected file and visible message in a report so the team can investigate. |
| Evaluation could not finish | Address the recorded cause, then use Retry check where offered. |
| Nothing to verify — no changes yet | The agent has no changes to check. Inspect its task and workspace before expecting a merge result. |
If the app reports that an agent workspace was removed or is not being tracked, choose Return to main to continue working in the main workspace. An old result does not establish the status of files that are no longer being checked.
After a retry, read the new status. Do not treat a disappeared error, an empty issue list, or an unfinished check as proof that the code passed. See Understand a verification result.
A rule looks wrong
Open Details beside the issue and compare the expectation, explanation, and source. In the Twitter example, clearSaved is expected to finish only after bookmark removals complete; the details show why its current code returns too early.
- The expectation is right and the code violates it: choose Fix and select Panolayer Agent or another installed agent. Follow Fix your first bug.
- The expectation describes the wrong behavior: correct the rule so it matches what the function should do, then run verification again and inspect the new result.
- The expectation is right but the reported failure appears incorrect: report the rule, the visible explanation, and a minimal example that reproduces it.
Changing an expectation is different from fixing the code. Do not weaken an accurate rule just to turn a failure into a pass.
An agent stops, or you can’t find its changes
Open My Agents and return to the conversation for that task. Choose Open on its run card. In Stream, select the relevant activity to inspect the command and its output in the right-hand panel. Read the error before sending another task.
A command or test failed? Check what the output actually says. A missing dependency, a rejected credential, and a failing application test need different fixes. Give the agent the failing command and the result you expect, keeping the follow-up tied to the same task. If the app shows a failure card, use its Technical details, Retry, or Report a bug controls.
The agent finished, but your checkout looks unchanged? Coding work happens in the agent’s worktree, separate from your main workspace. Open Changes and select that agent’s worktree on the right-hand side to see its uncommitted code. You can review worktrees, inspect changes by risk, and commit from Changes.
The run says Done, but the work is not merged? Completion and merge approval are separate. Review the verification summary and changed files, then decide whether to merge. A merge into your branch records the change locally; pushing to your remote is a separate step.
See Follow the agent’s work and Review changes and commit.
A graph step fails or the answer is incomplete
Inspect the step that failed and its output before changing the whole graph.
| What you see | What to check |
|---|---|
| The graph is read-only | Duplicate the built-in graph to edit your own copy. |
| An agent step needs a classification | Select the step and choose its agent classification in the right-hand panel. |
| A script fails immediately | Check Program, one argument per line, and Success exit code. The program must be available where the step runs. |
| The agent doesn’t use the question from this run | Check that Custom instructions includes the Goal variable inserted with @. |
| A failure has nowhere to go | Inspect the red failure route and connect an explicit handler or Failed destination. |
| The graph succeeds but the answer is incomplete | Read the agent step’s output, clarify its instructions, and test the same goal again. |
A successful script step means it met its configured success exit code. Check the actual output and the result you intended, too. After editing a failure route, test that path deliberately.
Follow Build your first AI agent graph for the working example and configuration screenshots.
A merge conflicts, or a push fails
Start in Changes. Select the relevant worktree and inspect what is waiting to be committed or merged. If you already approved an agent merge, find its commit in History before trying to commit the same work again.
If the merge reports conflicts:
- Read the conflict dialog. The agent’s work has not been merged yet, and its worktree remains available.
- Resolve each conflicted file in the agent’s worktree, save it, and stage that resolution with
git addin that worktree. You can also use the dialog’s action to ask the agent to resolve the conflicts, then review its edits. - Choose Refresh status. If the rebase is paused and the conflicts are staged, choose Continue rebase.
- Review the resulting changes, then use Review & retry merge when offered.
Do not resolve a conflict in a different checkout and expect the agent’s worktree to change with it.
If a push fails: read the Git error and check the configured remote and your permission to write to it. If the remote branch has moved on, reconcile the changes using your normal Git workflow before retrying. A local merge or commit remains local until a push succeeds. The Twitter sample may have no remote configured; a local commit is enough to complete its walkthrough.
See Review changes and commit for commit, History, and push controls.
Report a bug
If the problem persists, choose Report a bug in Panolayer, or contact the team. When an agent fails, use Report a bug on its failure card so the report includes that agent’s diagnostics.
You can use this template:
What I was trying to do:
Steps to reproduce:
1.
2.
3.
Expected result:
Actual result:
Exact error or status:
Panolayer version:
Mac chip and macOS version:
Agent name, if relevant:
Does it also happen in the Twitter Clone sample?
Include the file or function name when it helps locate the problem, and note whether it happened in the main workspace or an agent worktree. A small example you can share is more useful than an entire private repository. You don’t need to test the sample if it would interrupt your current work.
The report dialog includes diagnostics and logs, and can attach the current screen. Review the Screenshot attached control and any files you add before sending. Leave out credentials, API keys, and private source code you do not intend to share.
After sending, keep the tracking reference shown in the confirmation so you can refer to the same report when following up.