Referanse
Kommandoer, konfig og tabeller
Kommandoer, konfignøkler og tabeller på én side. Søk på siden med Ctrl+F (Cmd+F på Mac).
Kommandoer
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 --verbose | Start som vanlig og vis hva oppstarten gjør: sandkassemappe, klient, agent og modell |
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 mcp list | MCP-serverne i Navs register, hvilke du har slått på, og hva som hindrer dem i å virke |
nav-pilot mcp enable <navn> | Slå på en server fra registeret i Copilot CLI og opencode (--client for bare én) |
nav-pilot mcp disable <navn> | Slå av serveren, og slutt å slippe gjennom hostene som bare den trengte |
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 den 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 news | Vis de nyeste sakene fra ki-utvikling.nav.no, med lenke |
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/ (eller $XDG_CONFIG_HOME/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, modus, modell og hva agenten får gjøre selv |
nav-pilot config setup --advanced | Samme veiviser, pluss spørsmålet om nettverket: cplt-nivået standard eller strict |
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 |
Avslutningskoder
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.
Konfignøkler
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.
version1
Skjemaversjon. Mangler den, leses fila som versjon 1, og nav-pilot sier fra med én linje.
client--clientcopilot · opencode · pi (standard: opencode)
Klient å starte: copilot, opencode eller pi (eksperimentell). Alle kjører i cplt. Mangler nøkkelen i en eksisterende config.toml, betyr det copilot. Klienter.
source--sourceowner/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--modelmodell-id, f.eks. claude-opus-4.8
Modell å bruke. En Copilot-id som claude-opus-4.8 virker for copilot og opencode; opencode tar også provider/model. nav-pilot config explain model lister id-ene.
mode--modedefault · plan · autopilot (standard: default)
Modus for Copilot-agenten. plan tilsvarer opencode --agent plan; autopilot er bare Copilot.
reasoning_effort--effortnone · low · medium · high · xhigh · max
Resonneringsinnsats. Copilot bruker --effort, opencode bruker --variant.
context_tier--contextdefault · long_context
Kontekstnivå. Bare Copilot, og nav-pilot advarer om feltet er satt for opencode.
allow_all_tools--allow-all-tools / --no-allow-all-toolstrue · false (standard: false)
La agenten kjøre uten å spørre også med autonomy = conservative (Copilot: --allow-all-tools, OpenCode: --auto).
ask_user--ask-user / --no-ask-usertrue · false (standard: true)
La agenten stoppe og spørre deg. Bare Copilot, og nav-pilot advarer om feltet er satt for opencode.
autonomysandbox · conservative (standard: sandbox)
Hvor mye agenten gjør uten å spørre i cplt. sandbox: kjører kommandoer selv, og vaktene i cplt setter grensene. conservative: spør før hver handling. Mer om autonomy.
auto_launch--auto-launch / --no-auto-launchtrue · false (standard: true)
Start klienten etter sync eller installasjon. Med false skriver nav-pilot bare ut kommandoen.
auto_updatetrue · false (standard: false)
Oppgrader nav-pilot automatisk når en ny versjon er ute. Feiler det, kjører du videre på versjonen du har.
surveystrue · false (standard: true)
Spør av og til etter en økt om du vil svare på en kort brukerundersøkelse. false slår av spørsmålet og engangstipset om opencode; DO_NOT_TRACK og NAV_PILOT_TELEMETRY_ENABLED=false gjør det samme. Brukerundersøkelser.
newstrue · false (standard: true)
Vis én linje etter en økt når det er kommet en ny nav-pilot-sak, én gang per sak. nav-pilot news lister sakene uansett. Nyheter.
log_level--log-levelnone · error · warning · info · debug · all · default
Loggnivå for Copilot CLI.
otel_log_level--otel-log-levelnone · 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_enabledtrue · 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_autostarttrue · 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_guardet heltall (standard: 8)
Hvor mange like verktøykall på rad som avslutter en runde for den lokale modellen, uansett hva kallene returnerer. Gir kallene samme resultat hver gang, stopper runden etter halvparten så mange kall (minst 2).
local_modelmodell-id fra manifestet
Hvilken lokal modell serveren laster (alfa). Tom betyr standardmodellen i manifestet. Sett den med nav-pilot alpha local use <key>.
local_endpointen http(s)-URL
Din egen OpenAI-kompatible server (Ollama, llama-server), bare localhost eller privat IP (alfa, uten støtte). Sjekk den med nav-pilot alpha local doctor.
local_endpoint_modelmodell-id på serveren
Modell-id-en local_endpoint skal bruke, f.eks. qwen3.6:35b. Påkrevd sammen med local_endpoint.
local_dispatch--local-dispatchoff · conservative · balanced · aggressive (standard: aggressive)
Hvor mye hovedagenten i opencode delegerer til den lokale modellen. aggressive delegerer mest, men kostet flere AI-kreditter og tok lengre tid i målingene. Delegering.
hook_loop_guardtrue · 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_secretstrue · 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_fnrtrue · 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_notetrue · 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.
hook_action_checkoff · log (standard: log)
Spør den lokale decide-modellen om en risikabel skallkommando (kubectl, terraform apply, rm -r, git push --force og lignende) står i forhold til formålet. log lagrer svaret og stopper ingenting. Krever lokal modell. Hvilke kommandoer.
mcp_hostsask · off (standard: ask)
Om nav-pilot spør før den åpner cplt for hostene MCP-serverne dine trenger. Hostene hentes fra Navs MCP-register. ask spør én gang per sett, off spør aldri.
copilot_auth_modeauto · 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.
Sikkerhetsnivå i cplt
Nivået er sandbox.preset i cplt. Hva nivåene betyr, og hvordan du bytter, står i Sandkassen.
| Innstilling | standard | strict |
|---|---|---|
gh_guard | på | på |
git_guard | blokkerer push til default branch og force push | blokkerer all push |
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).
Telemetri
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. |
Lokale modeller alfa
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 å delegere 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 LLM-server: finner den, foreslår modell og sjekker den nav-pilot alpha local doctor # egen LLM-server: sjekker verktøykall, logprobs, kontekst og tid til første token
4 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 | Minst minne | Kontekst / svar | nav-pilot |
|---|---|---|---|
Qwen3.6-35B-A3B-OptiQ-4bit standardRask og forutsigbar, og svarer på sekunder. Det eneste hovedagenten kan delegere hit uten forbehold, er en mekanisk endring over flere filer. | 48 GB vekter 25 GB | 64k / 16k | alle |
Qwen3.8-27B-OptiQ-4bit valgfriMye 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. | 48 GB vekter 19 GB | 64k / 8k | alle |
Qwen3.8-27B-8bit valgfriDen 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. | 48 GB vekter 30 GB | 48k / 4k | fra 24. sep. 2026 |
Qwen3.6-35B-A3B-8bit valgfriStandardmodellen i 8 bit, for Macer med 64 GB minne eller mer. Du må velge den selv. Ingen oppgavetyper er godkjent for den ennå, så hovedagenten delegerer ingenting til den. | 64 GB vekter 38 GB | 64k / 16k | alle |
Står det en dato under «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.
Filstruktur
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
Lenker
- Kom i gang: installer nav-pilot og cplt
- Guider: installere, tilpasse, synkronisere, lokal modell og feilsøking
- Forklaring: hvorfor nav-pilot virker som det gjør
- Klienter: Copilot CLI, opencode og pi, og hva hver av dem kan
- Agentpakker: for deg som vil lage eller bygge videre på en pakke
- Verktøykatalog: installer enkeltkomponenter
- README.nav-pilot.md på GitHub