Guider
Start med nav-pilot doctor. Den finner det meste og sier hva du skal gjøre.
nav-pilot doctor # konfig, installasjon, hooks, klienter, cplt og git nav-pilot config validate # bare konfigfila: syntaks, nøkler og verdier nav-pilot alpha local doctor # bare egen server (local_endpoint)
doctor sjekker konfigfila, det som er installert i ~/.copilot og i repoet, hooks, klientene (Copilot CLI, opencode og pi), cplt, modellvalgene, sandkassen og git. Hvert problem kommer med kommandoen som løser det. Den endrer ingenting, og avslutter med kode 0 også når den finner noe, så les linjene med «Solution».
alpha local doctor sjekker verktøykall, logprobs, kontekstlengde og tid til første token på serveren du kjører selv. Kontekstsjekken kan ta minutter på en CPU. Den gjelder ikke modellen nav-pilot setter opp på Mac. Der bruker du nav-pilot alpha local status.
Finner du en feil, meld den med nav-pilot feedback. Den åpner et issue i navikt/copilot med versjon og systeminformasjon fylt inn. Ingenting går ut før du sender inn issuet.
proxy.log_level bestemmer hva proxyen i cplt skriver til stderr. Standard er none, men cplt hever den selv til blocked når en host-liste er aktiv. Setter du sikkerhetsnivået med nav-pilot, skriver den alltid en host-liste, så på strict ser du blokkeringene uten å gjøre noe.
Kjører du standard uten egen proxy.allowed_domains, tier proxyen om alle blokkeringer: treff i cplts egen blokkliste, stengte porter, hoster som peker til private eller link-local IP-adresser, og oppslag som feiler. Vil du se dem, sett nivået selv:
cplt config set proxy.log_level blocked
Vil du ha en fil å lese etterpå, bruk proxy.log_file. Den dekker det proxyen avgjør, ikke det gh- og git-vakta avgjør. audit.enabled ser ut som det samme, men gir ingen logg i dagens cplt: cplt config show viser seksjonen [audit], men ingenting bruker den. sandbox.audit er noe annet og allerede på. Den viser hvilke filer agenten endret, etter at den er ferdig.
Nivåene står i referansen.
status skiller «treg» fra «død».
nav-pilot alpha local status # står det hung: nav-pilot alpha local restart
nav-pilot slipper gjennom én forespørsel om gangen, så flere oppgaver står i kø i stedet for å kjøre samtidig. Serveren tar imot samtidige forespørsler og henger seg opp på dem, så ikke kall den direkte utenom nav-pilot.
nav-pilot avslutter en tur hvis modellen gjør det samme verktøykallet fire ganger på rad og får samme resultat hver gang, eller åtte ganger på rad uansett resultat, og sier fra i økten. Det er en vakt mot at modellen står fast, ikke en feil i koden din. Grensene endrer du med local_loop_guard.
Går modellen tom for minne, for eksempel på en lang prompt, avslutter serveren seg selv. Neste økt sier generation thread died, most likely out of memory, med stien til tracebacken. Start den igjen med nav-pilot alpha local restart. Skjer det igjen, velg en modell med kortere kontekst.
Starter du serveren på nytt midt i en økt, må du starte økten på nytt også. Den gamle er bundet til serveren som forsvant.
Si fra med nav-pilot feedback om noe henger, om en endring kompilerer men er feil, eller om ventetiden ikke er verdt det. Dårlige erfaringer er like nyttige som gode.