Referanse
Kommandoer, konfignøkler og tabeller på én side. Søk på siden med Ctrl+F.
nav-pilot help <kommando> viser alle flaggene til en kommando. install spør om du vil installere i repoet (.github/) eller i hjemmekatalogen (~/.copilot/). Med --repo eller --user svarer du på forhånd.
| Kommando | Hva den gjør |
|---|---|
nav-pilot | Interaktivt: installer, oppgrader eller start Copilot-sandkassen (cplt) |
nav-pilot --client opencode | Start opencode med Nav-konteksten på plass |
nav-pilot -- -p "…" | Start klienten med argumentene etter -- uten meny, spørsmål fra nav-pilot eller sync, med eller uten terminal (CI, skript). Legg til --sync for å synkronisere først. I en terminal viser cplt fortsatt sin egen bekreftelse |
nav-pilot install nav-pilot | Installer agentpakka. Spør om repoet (.github/) eller hjemmekatalogen (~/.copilot/) |
nav-pilot install --user | Installer agenter, skills og instruksjoner til ~/.copilot (alle repoer) |
nav-pilot install --dry-run nav-pilot | Forhåndsvis hva som installeres |
nav-pilot install --force nav-pilot | Overskriv lokalt endrede filer |
nav-pilot list | Vis agentpakka og enkeltkomponenter |
nav-pilot list --installed | Vis installerte filer og integritet |
nav-pilot doctor | Sjekk konfig, installasjon, hooks, klienter, cplt og git |
nav-pilot install <name> | Installer én komponent (agent, skill osv.) |
nav-pilot install <name> --type <type> | Installer med eksplisitt type (agent, skill, instruction, prompt) |
nav-pilot ignore <type> <name> --user | Stopp varsel om en komponent uten å installere den |
nav-pilot uninstall | Fjern det nav-pilot installerte i repoet. --user gjør det samme i ~/.copilot |
nav-pilot install <name> --frozen | Installer nøyaktig det .nav-pilot/agentpakke.lock.json peker på, eller avslutt med kode 3 |
nav-pilot rollback | Flytt agentpakka i ~/.copilot tilbake til forrige versjon |
nav-pilot init | Lag AGENTS.md og Copilot-instruksjoner med TODO-er i repoet |
nav-pilot sync | Sjekk om oppdateringer finnes (kode 1 hvis ja) |
nav-pilot sync --apply | Oppdater filer direkte |
nav-pilot sync --json | Resultatet som JSON |
<command> --json | JSON på stdout for install, list, sync, export, rollback, validate, ignore, models, usage, version og config (show, path, get, validate). doctor, uninstall og upgrade har ikke JSON |
nav-pilot models | Modellene klienten kan bruke, med den du har valgt merket |
nav-pilot models claude | Filtrer lista: bare modellene med «claude» i id-en eller navnet |
nav-pilot models --client opencode | Vis lista for en annen klient |
nav-pilot env | Skriv miljøvariablene for Copilot CLI, til eval i skallprofilen |
nav-pilot upgrade | Oppdater nav-pilot CLI til nyeste versjon |
nav-pilot upgrade --dry-run | Bare sjekk: vis gjeldende → nyeste versjon. Kode 1 når en oppdatering finnes, 0 når du har nyeste |
nav-pilot feedback | Meld en feil. Åpner et issue i navikt/copilot med versjon og systeminformasjon |
nav-pilot feedback --feature | Foreslå ny funksjon |
nav-pilot survey | Svar på en åpen brukerundersøkelse, også når nav-pilot ikke spør selv |
nav-pilot export opencode | Skriv agentpakka til .opencode/ i repoet, i formatet til opencode. Trengs ikke for å bruke opencode |
nav-pilot export opencode --user | Skriv til ~/.config/opencode/ i stedet, for alle repoer |
nav-pilot config | Interaktiv innstillingsside i terminalen |
nav-pilot config init | Opprett ~/.nav-pilot/config.toml med alle valg kommentert ut |
nav-pilot config setup | Veiviser for klient, modell og modus |
nav-pilot config show | Vis gjeldende konfig: fila pluss standardverdiene |
nav-pilot config get <key> | Hent én verdi |
nav-pilot config set <key> <value> | Sett én verdi |
nav-pilot config validate | Sjekk konfigfila |
nav-pilot export opencode --dry-run | Forhåndsvis hva som eksporteres |
nav-pilot version | Vis versjonen |
nav-pilot alpha local <command> | Lokal modell (alfa): init, start, status, models, use, restart, stop, ask, on, off, purge |
nav-pilot alpha decide "<spørsmål>" --options a,b | Avgjørelse med faste alternativer fra den lokale modellen (alfa). Se --help |
Kodene under gjelder alle kommandoer. doctor avslutter alltid med 0, også når den finner feil. Les linjene med «Solution». Kommandoene under alpha local har egne koder, som står i --help.
| Kode | Når |
|---|---|
0 | Kommandoen gikk bra. sync og upgrade --dry-run: du har nyeste versjon. |
1 | Feil. sync og upgrade --dry-run: en oppdatering finnes. validate: agentpakka bryter kontrakten. |
2 | sync feilet, også når GitHubs release-API ikke svarer (låsen i repoet blir stående). install uten terminal og uten --yes, --all eller --frozen: den skriver ingenting og sier hva den ville ha skrevet. |
3 | install --frozen installerte ikke det .nav-pilot/agentpakke.lock.json peker på: ingen lås, ingen låst versjon, en annen versjon eller en delvis installasjon. |
klientens | Når nav-pilot starter en klient, gir den videre klientens avslutningskode. Kunne den ikke starte klienten, blir koden 1. En klient som ble stoppet av et signal, gir 128 pluss signalnummeret, slik et skall gjør. |
sync --json gir ett dokument med én oppføring per installasjonssted. Et sted som feilet, har feltet error.
nav-pilot leser ~/.nav-pilot/config.toml, eller fila NAV_PILOT_CONFIG peker på. Det finnes ingen konfig per repo. Et flagg vinner over fila, og fila vinner over standardverdien. Slik endrer du dem: Endre innstillinger.
| Nøkkel | Flagg | Verdier | Hva den gjør |
|---|---|---|---|
version | — | 1 | Skjemaversjon. Mangler den, leses fila som versjon 1, og nav-pilot sier fra med én linje. |
client | --client | copilot · opencode · pi (standard: copilot) | Klient å starte: copilot, opencode eller pi (eksperimentell). Alle kjører i cplt-sandkassen når cplt finnes. Mangler cplt, spør nav-pilot i terminalen om copilot eller opencode skal starte uten sandkasse (standard nei). Uten terminal, for eksempel i CI, starter de bare med --no-sandbox. |
source | --source | owner/name eller en absolutt sti (standard: navikt/copilot) | Hvor agentpakka hentes fra: et GitHub-repo eller en lokal checkout. Settes av install --source --save-source; nav-pilot config unset source går tilbake til standarden. |
model | --model | modell-id, f.eks. claude-opus-4.8 | Modell å bruke. En Copilot-id som claude-opus-4.8 virker for copilot og opencode (opencode kjører den som github-copilot/<id>); opencode tar også provider/model. nav-pilot config explain model lister id-ene. |
mode | --mode | default · plan · autopilot (standard: default) | Modus for Copilot-agenten. plan tilsvarer opencode --agent plan; autopilot er bare Copilot. |
reasoning_effort | --effort | none · low · medium · high · xhigh · max | Resonneringsinnsats. Copilot bruker --effort, opencode bruker --variant. |
context_tier | --context | default · long_context | Kontekstnivå. Bare Copilot, og nav-pilot advarer om feltet er satt for opencode. |
allow_all_tools | --allow-all-tools / --no-allow-all-tools | true · false (standard: false) | La agenten kjøre alle verktøy uten å spørre først. |
ask_user | --ask-user / --no-ask-user | true · false (standard: true) | La agenten stoppe og spørre deg. Bare Copilot, og nav-pilot advarer om feltet er satt for opencode. |
auto_launch | --auto-launch / --no-auto-launch | true · false (standard: true) | Start klienten etter sync eller installasjon. Med false skriver nav-pilot bare ut kommandoen. |
auto_update | — | true · false (standard: false) | Oppgrader nav-pilot automatisk når en ny versjon er ute, uten å spørre. Feiler oppgraderingen, kjører kommandoen på versjonen du har, og neste forsøk kommer etter 24 timer. |
surveys | — | true · false (standard: true) | Spør av og til, etter en økt, om du vil svare på en kort brukerundersøkelse (høyst tre ganger per undersøkelse). Med false spør nav-pilot aldri. DO_NOT_TRACK og NAV_PILOT_TELEMETRY_ENABLED=false slår det også av. |
log_level | --log-level | none · error · warning · info · debug · all · default | Loggnivå for Copilot CLI. |
otel_log_level | --otel-log-level | none · error · warning · warn · info · debug · verbose · all (standard: none) | Loggnivå for OpenTelemetry i Copilot CLI (OTEL_LOG_LEVEL). En OTEL_LOG_LEVEL i skallet vinner, og config show merker den env. |
local_enabled | — | true · false (standard: false) | Send avgrensede oppgaver til en lokal modell (alfa). Settes av alpha local init, nullstilles av alpha local off. Så lenge den er false, ser nav-pilot ingen lokale modeller. |
local_autostart | — | true · false (standard: false) | La en vanlig nav-pilot starte den lokale serveren når den trengs og ingen kjører. Av som standard: en prosess på 21 GB skal ikke starte uten at du har bedt om det. |
local_loop_guard | — | et heltall (standard: 8) | Hvor mange identiske verktøykall på rad som avslutter en lokal tur, uansett hva de returnerer. Gir kallene samme resultat hver gang, holder det med halvparten (minst 2). |
local_model | — | modell-id fra manifestet | Hvilken lokal modell serveren laster (alfa). Tom betyr standardmodellen i manifestet. Sett den med nav-pilot alpha local use <key>. |
local_endpoint | — | en http(s)-URL | Din egen OpenAI-kompatible server (Ollama, llama-server), f.eks. http://127.0.0.1:11434/v1 (alfa, uten støtte, ikke målt). Da laster nav-pilot ikke ned og starter ingenting. Bare localhost og private IP-adresser. Sjekk den med nav-pilot alpha local doctor. |
local_endpoint_model | — | modell-id på serveren | Modell-id-en local_endpoint skal bruke, f.eks. qwen3.6:35b. Påkrevd sammen med local_endpoint. |
local_dispatch | --local-dispatch | off · conservative · balanced · aggressive (standard: balanced) | Hvor mye arbeid hovedagenten i skyen skal sende til den lokale modellen i opencode. Med balanced stopper nav-pilot hovedagentens egen redigering én gang når en mekanisk endring når fem filer, ti redigeringer eller en skriptet løkke. Med aggressive slipper den gjennom først når fila er sendt til den lokale modellen, og det samme gjelder nye filer. Stoppet gjelder bare oppgavetyper manifestet har godkjent modellen for. |
hook_loop_guard | — | true · false (standard: true) | Samme løkkeregel i alle Copilot CLI-økter, også i skyen: en postToolUse-hook i ~/.copilot/hooks/ sier fra til modellen når den står fast. false fjerner hooken ved neste oppstart. |
hook_redact_secrets | — | true · false (standard: true) | Masker hemmeligheter (GitHub-tokener, AWS-nøkkel-id-er, private nøkler, JWT-er, verdien i password=/api_key=) i verktøyresultater før modellen leser dem, i alle Copilot CLI-økter. |
hook_redact_fnr | — | true · false (standard: true) | Masker fødselsnummer, D-nummer og H-nummer i verktøyresultater. nav-pilot maskerer bare elleve sifre der datoen og begge kontrollsifrene stemmer. |
hook_injection_note | — | true · false (standard: true) | Sett en merknad foran verktøyresultater som ser ut som instrukser til modellen («ignore previous instructions», rollemarkører), så modellen behandler dem som data. Stopper ingenting. |
copilot_auth_mode | — | auto · env_only · gh_only (standard: auto) | Hvilken innlogging som når cplt for Copilot. auto begrenser ingenting; env_only krever et token i GH_TOKEN, GITHUB_TOKEN eller COPILOT_GITHUB_TOKEN; gh_only fjerner dem. |
Nivået er sandbox.preset i cplt. Sett det med nav-pilot config, raden «cplt security posture», så kommer Nav-hostene med. Hvorfor står i Sandkassen.
| Innstilling | standard | strict |
|---|---|---|
gh_guard | på | på |
git_guard | advarer | blokkerer |
proxy.forced (tvungen proxy) | av | på |
proxy.default_allowlist | av | på: bare cplts egen liste og proxy.allowed_domains |
Host-lista nav-pilot skriver: ~/.nav-pilot/cplt-allowed-domains.txt. På Linux krever strict Landlock ABI v4 (kjerne 6.7 eller nyere).
Slå av målingene i skallprofilen din med én av disse. Hva som måles og hvorfor, står i Personvern og telemetri. Hele lista står i TELEMETRY.md.
| Variabel | Virkning |
|---|---|
DO_NOT_TRACK=1 | Slår av målingene i nav-pilot, i Copilot og opencode når nav-pilot starter dem, og i andre verktøy som følger konvensjonen. |
NAV_PILOT_TELEMETRY_ENABLED=false | Slår av målingene i nav-pilot. |
nav-pilot alpha local init # laster ned modellen, setter opp miljøet og starter serveren nav-pilot alpha local init --yes # det samme fra et skript, uten å spørre nav-pilot alpha local start # starter serveren igjen etter en omstart av maskinen nav-pilot alpha local status # kjører den? svarer den? hvilken modell? hva har den gjort? nav-pilot alpha local models # modellene som tilbys, og hvilken som er i bruk nav-pilot alpha local use <key> # velg modellen serveren laster nav-pilot alpha local ask -p "..." # still ett spørsmål rett til modellen nav-pilot alpha decide "..." --options ja,nei --evidence fil # avgjørelse med faste alternativer nav-pilot alpha local stop nav-pilot alpha local restart # stop og start i ett nav-pilot alpha local on # skru på igjen etter off nav-pilot alpha local off # slutt å sende oppgaver dit; vektene blir liggende nav-pilot alpha local purge # viser hva som fjernes og hvor mye; --yes sletter, --all tar alle modellene nav-pilot alpha local setup # egen server: finner den, foreslår modell og sjekker den nav-pilot alpha local doctor # egen server: sjekker verktøykall, logprobs, kontekst og tid til første token
3 modeller er tilgjengelige. Én er standard, resten velger du selv. Tabellen hentes fra modellmanifestet, det samme nav-pilot leser når du kjører init og start. Kontekst og svar er det største vinduet og det lengste svaret nav-pilot gir modellen.
| Modell | Kontekst / svar | Minne | Krever nav-pilot | Kort sagt |
|---|---|---|---|---|
Qwen3.6-35B-A3B-OptiQ-4bitstandard | 64k / 16k | 48 GB, vektene tar 25 GB | alle versjoner | Rask og forutsigbar, og svarer på sekunder. Det eneste hovedagenten kan sende hit uten forbehold, er en mekanisk endring over flere filer. |
Qwen3.8-27B-OptiQ-4bitvalgfri | 64k / 8k | 48 GB, vektene tar 19 GB | alle versjoner | Mye tregere enn standardmodellen. Bruker 8 bit på de mest følsomme lagene og 4 bit på resten. I siste måling nådde ingen oppgaver tidsgrensen. Det gjorde den vanlige 4-bit-versjonen den erstatter. |
Qwen3.8-27B-8bitvalgfri | 48k / 4k | 48 GB, vektene tar 30 GB | ≥ 2026.09.24-110317-3596754 | Den tregeste. Løste litt flere oppgaver enn standardmodellen i siste måling, men bruker mange ganger så lang tid. Leser lange prompter i små steg for å bruke mindre minne, og det steget kjenner bare nyere nav-pilot til. |
Står det en versjon under «Krever nav-pilot», skjuler eldre versjoner av nav-pilot modellen. Peker local_model på den, faller nav-pilot tilbake til standardmodellen, og init, start og status sier hvilken versjon du trenger. Oppdater med nav-pilot upgrade.
Standardmodellen kjører med temperatur 0,6 og top_p 0,95, verdiene den ble målt med.
Én kjøring er ikke en måling. Alle kjøringene står i MODELS.md. Hva hver modell er godkjent for, står i Målte grenser.
Filene nav-pilot install --repo legger i .github/. Copilot leser dem og tilpasser svarene. Klikk på en fil for å se hva den gjør.
.github/
Definerer @nav-pilot sin persona, hvilke skills den bruker, og hvordan den delegerer til andre agenter. Copilot leser denne filen når du skriver @nav-pilot i chatten.
Aktiveres: Når du skriver @nav-pilot i Copilot Chat
Velg klient med --client eller med client i konfigfila: nav-pilot config set client opencode.
| Klient | Status | Hva du får |
|---|---|---|
copilot | Standard | GitHub Copilot CLI i cplt-sandkassen. Agentpakka virker også i VS Code, JetBrains og på github.com. |
opencode | Full støtte | nav-pilot legger Nav-konteksten i ~/.config/opencode/ og holder den oppdatert. |
pi | Eksperimentell | pi i cplt-sandkassen, med skills, agenter og AGENTS.md lagt inn ved oppstart. Krever både pi og cplt. |
For copilot henter nav-pilot ikke GitHub-tokenet selv. Er gh-vakta i cplt på, henter cplt det fra GH_TOKEN, GITHUB_TOKEN, COPILOT_GITHUB_TOKEN eller gh auth token. copilot_auth_mode bestemmer hvilke kilder som slipper gjennom: env_only stopper oppstarten uten token i miljøet, og gh_only fjerner token-variablene.
Med --client opencode legger nav-pilot AGENTS.md, skills, kommandoer og agenter i ~/.config/opencode/ og oppdaterer dem ved hver oppstart.
~/.config/opencode/.nav-pilot-state.json holder rede på hvilke filer og hvilken versjon som er installert.tools:-lista til en agent blir tillatelser i opencode.nav-pilot doctor viser hvilke servere som slås av, og om versjonen av opencode er testet.mode = autopilot, context_tier og ask_user gjelder bare Copilot. Har du satt dem og bruker opencode, skriver nav-pilot én advarsel. nav-pilot export opencode skriver agentpakka til .opencode/ i repoet, men trengs ikke for å bruke opencode.
3 modeller er tilgjengelige. Én er standard, resten velger du selv. Tabellen hentes fra modellmanifestet, det samme nav-pilot leser når du kjører init og start. Kontekst og svar er det største vinduet og det lengste svaret nav-pilot gir modellen.
| Modell | Kontekst / svar | Minne | Krever nav-pilot | Kort sagt |
|---|---|---|---|---|
Qwen3.6-35B-A3B-OptiQ-4bitstandard | 64k / 16k | 48 GB, vektene tar 25 GB | alle versjoner | Rask og forutsigbar, og svarer på sekunder. Det eneste hovedagenten kan sende hit uten forbehold, er en mekanisk endring over flere filer. |
Qwen3.8-27B-OptiQ-4bitvalgfri | 64k / 8k | 48 GB, vektene tar 19 GB | alle versjoner | Mye tregere enn standardmodellen. Bruker 8 bit på de mest følsomme lagene og 4 bit på resten. I siste måling nådde ingen oppgaver tidsgrensen. Det gjorde den vanlige 4-bit-versjonen den erstatter. |
Qwen3.8-27B-8bitvalgfri | 48k / 4k | 48 GB, vektene tar 30 GB | ≥ 2026.09.24-110317-3596754 | Den tregeste. Løste litt flere oppgaver enn standardmodellen i siste måling, men bruker mange ganger så lang tid. Leser lange prompter i små steg for å bruke mindre minne, og det steget kjenner bare nyere nav-pilot til. |
Står det en versjon under «Krever nav-pilot», skjuler eldre versjoner av nav-pilot modellen. Peker local_model på den, faller nav-pilot tilbake til standardmodellen, og init, start og status sier hvilken versjon du trenger. Oppdater med nav-pilot upgrade.
Standardmodellen kjører med temperatur 0,6 og top_p 0,95, verdiene den ble målt med.