docs

CLI-referansen

Én binær, alle flatene. Hver kommando har --json med stabilt schema, og ingen kommando stiller interaktive spørsmål når --json eller CI=true er satt.

kontrakt 0.2.70--json på alt

Felles flagg og miljø

nysky  [--json] [--konto ] [--config nysky.toml] [--api URL]
  • --json — maskinlesbar utgang med stabilt schema; feil følger RFC 7807. Svaret bærer kontraktversjonen.
  • --konto — velg konto når innloggingen har flere. Navn eller konto-id.
  • --config — peker på et annet manifest enn ./nysky.toml.

Miljø: NYSKY_API_URL (default api.nysky.no/v1) og NYSKY_API_TOKEN. NB: er NYSKY_API_TOKEN satt, vinner den stille over nysky login-innloggingen.

Innlogging og team

  • login — logg inn med nysky ID (passkey) i nettleseren — du krysser av hvilke kontoer maskinen får. login status viser tilstanden, login --nytt tvinger ny runde.
  • logout [--overalt] — fjern innloggingen lokalt; --overalt trekker tokenene tilbake på plattformen, også for andre maskiner og agenter.
  • team list | add <epost> [--admin] | remove <epost> — utviklerne på kontoen. En gatet app uten delingsliste slipper inn nettopp disse.
  • allow list <app> | add <app> <epost|@domene> | remove — delingslisten per app — virker med én gang, uten redeploy.

Bygg, deploy og status

  • dev — bygg og kjør appen lokalt, i samme kjøretid som i drift.
  • plan — vis hva en deploy ville endret — ruter, bindings, nivå — uten sideeffekter.
  • deploy [--wait] — bygg bundelen deterministisk, last opp og konvergér. Samme kilde gir samme resultat.
  • apps — alle appene dine: navn, tilstand, adresse.
  • status [app] — tilstand, adresse, rollout-feil og siste push-deploy.
  • feilbilde [app] — helsesignal uten forespørselsdata — trygt å dele med en assistent.
  • secret put <NAVN> — sett hemmelighet skriv-kun; verdien leses fra stdin og kan aldri hentes ut. --preview setter preview-miljøsettet; secret request lager en engangslenke der et menneske limer inn verdien; secret delete fjerner.
  • ci run — kjør [ci]-kommandoen i plattformens byggemiljø i Norge — ingen egen CI-runner.
  • logs — les appens krypterte logg, dekryptert lokalt med din nøkkel. logs keygen lager nøkkelpar og registrerer mottakeren på kontoen; logs purge sletter lagrede segmenter.

Previews og livssyklus

  • preview <app> — liste over PR-previews. behold <navn> [dager] forlenger, riv fjerner, klone kopierer appens database inn i previewet (bekreftes med passkey), planlegg <navn> <tid> promoterer bygget på et tidspunkt med automatisk tilbakerulling, planer/avbryt styrer køen.
  • app vekk|slett [navn] [--permanent] — livssyklus via bekreftelsesluken: CLI-en lager intensjonen, et menneske bekrefter med passkey. Sletting har 28 dagers angrefrist; --permanent hopper over den.
  • wake [app] — vekk en parkert app.

Git og push-to-deploy

  • git login — koble git-credential til nysky ID — engangs; deretter virker vanlig git mot git.nysky.no.
  • git repo create <navn> [--public] — opprett repo og sett origin. repo collab add gir andre tilgang.
  • git branch | pr | issue … — grener (ls/create/rm/protect), pull requests (create/ls/merge) og issues (create/ls/close).
  • git deploy enable <eier>/<repo> [--branch <gren>] — push-to-deploy: hver push til grenen ruller ut appen. list/status/disable styrer koblingen.
  • git api <METODE> </sti> [json] — hele Git-API-et, autentisert.

Konto, domener og data

  • konto — saldo og apper. kvitteringer [--pdf id], forbruk, varsler, eksport; flytt/pafyll flytter kreditt i kontofamilien; sandkasse foreslår en agent-sandkasse med budsjett (mennesket bekrefter); avslutt går via bekreftelsesluken.
  • domene — .no-domener selvbetjent: sjekk, mine, poster [sett], ns, dnssec på/av, forny auto/av, authkode, overta <navn> (flytt inn med authkode — mennesket bekrefter med passkey). Kjøp gjøres av et menneske på kontosiden.
  • datastoreps (aktivitet), restart, skjema (tabeller og kolonner — aldri radene), ovingsdata (fyller testmiljøet med syntetiske rader).
  • konsoll — åpne kontosiden i nettleseren — kjøp og eierskifte krever et menneske.

Alle kommandoer har --json med stabilt schema.

Hemmeligheter og handlinger med konsekvens krever et menneske med passkey.

CLI-en er hele flaten — alt UI-et kan, kan CLI-en.

Videre