copilot

KO | EN

gitlite — search

#react #ai #typescript #llm #golang #android #machine-learning #macos #windows #awesome #cli #pytorch #security #mcp

(★ 52)

All things Copilot, Agents, MCPs, Skills, and coding related AI features for the Norwegian Government

copilot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🤖 Nav Copilot Customizations

![Nav Copilot tools page](https://raw.githubusercontent.com/navikt/copilot/main/docs/assets/my-copilot-hero.png)

Agenter, instruksjoner, skills og MCP-servere som gjør GitHub Copilot smartere for Navs stack. Alt samlet i én verktøyskatalog.

## Hva er dette?

En samling Copilot-tilpasninger for Nav-økosystemet:

- **🤖 [13 Agenter](docs/README.agents.md)** — Spesialiserte AI-assistenter for Nav-domener
- **📋 [16 Instruksjoner](docs/README.instructions.md)** — Kodestandarder som aktiveres automatisk basert på filmønster
- **⚡ [7 Prompts](docs/README.prompts.md)** — Scaffolding-maler for vanlige Nav-mønstre
- **🎯 [31 Skills](docs/README.skills.md)** — Produksjonsmønstre fra ekte Nav-repoer
- **🔌 [MCP-servere](docs/README.mcp.md)** — Nav-godkjente MCP-servere fra registeret

Alle tilpasninger finnes på **[verktøysida](https://min-copilot.ansatt.nav.no/verktoy)** med søk, filtrering og installeringshjelp.

### Innhold

- [Hva er dette?](#hva-er-dette) — oversikt og nav-pilot
- [Kom i gang](#kom-i-gang) — installer tilpasninger
- [Tilpasninger](#tilpasninger) — agenter, instruksjoner, skills, prompts, MCP
- [Applikasjoner](#️-applikasjoner) — portalen, metrikker, MCP-register, onboarding
- [Nav Tech Stack](#️-nav-tech-stack) — stack som dekkes
- [Repository Structure](#-repository-structure) — mappestruktur
- [Bidra](#-bidra) — legg til tilpasninger
- [Team](#-team)
- [Lisens](#-lisens)
- [Ressurser](#-ressurser)

### 🧭 nav-pilot — Nytt!

**[nav-pilot](docs/README.nav-pilot.md)** er et CLI-verktøy og en AI-agent. CLI-et klargjør repoet ditt med riktige agenter, skills og instruksjoner, og sørger automatisk for en optimalisert integrasjon (inkludert token-optimalisering). Agenten (`@nav-pilot`) guider deg gjennom fire faser (Intervju → Plan → Review → Lever) i Copilot Chat.

```bash
# Installer nav-pilot CLI
brew install navikt/tap/nav-pilot

# Installer Kotlin-backend-samlingen i repoet ditt
cd /path/to/your/repo
nav-pilot install kotlin-backend

# Bruk i Copilot
@nav-pilot Jeg trenger en ny tjeneste som behandler dagpengesøknader
```

**[Les mer →](docs/README.nav-pilot.md)** · **[Samlinger →](docs/README.collections.md)**

## Kom i gang

### Fra verktøysiden (anbefalt)

Gå til **[min-copilot.ansatt.nav.no/verktoy](https://min-copilot.ansatt.nav.no/verktoy)**, finn det du trenger og følg installeringsstega. MCP-servere har ferdige `code --add-mcp`-kommandoer du kan kopiere rett inn i terminalen.

### Fra dokumentasjonen

- **[Agenter →](docs/README.agents.md)** — VS Code one-click, JetBrains via coding agent
- **[Instruksjoner →](docs/README.instructions.md)** — Alle editorer
- **[Prompts →](docs/README.prompts.md)** — VS Code, JetBrains
- **[Skills →](docs/README.skills.md)** — VS Code (`security-owasp` dekker OWASP Top 10:2025 for Kotlin, Go, Java og Node.js)
- **[MCP-servere →](docs/README.mcp.md)** — Alle editorer
- **[Samlinger →](docs/README.collections.md)** — Installer alt på én gang
- **[nav-pilot →](docs/README.nav-pilot.md)** — CLI-verktøy og AI-agent for Nav-tilpasninger
- **[Testing →](docs/README.testing.md)** — Strukturelle og E2E-tester for nav-pilot
- **[Hold tilpasninger oppdatert →](docs/README.sync.md)** — Automatisk sync-workflow (som Dependabot)

### Med MCP Onboarding

Bruk **MCP Onboarding**-serveren for å utforske tilpasninger, sjekke agent-readiness og generere AGENTS.md — direkte fra Copilot Chat.

---

## Tilpasninger

| Type                | Beskrivelse                                                                             | Dokumentasjon                                      |
| ------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------- |
| 🤖 **Agenter**       | Spesialiserte AI-assistenter for Nav-domener — bruk med `@agent-name` i Copilot Chat    | **[Agenter →](docs/README.agents.md)**             |
| 📋 **Instruksjoner** | Kodestandarder som aktiveres automatisk basert på filmønster (`*.kt`, `*.tsx`, `*.sql`) | **[Instruksjoner →](docs/README.instructions.md)** |
| ⚡ **Prompts**       | Scaffolding-maler tilgjengelig via `#prompt-name` i Copilot Chat                        | **[Prompts →](docs/README.prompts.md)**            |
| 🎯 **Skills**        | Produksjonsmønstre med innebygde maler og referanser                                    | **[Skills →](docs/README.skills.md)**              |
| 🔌 **MCP-servere**   | Nav-godkjente servere fra [MCP-registeret](https://mcp-registry.nav.no)                 | **[MCP-servere →](docs/README.mcp.md)**            |
| 🔄 **Sync**          | Hold tilpasninger oppdatert automatisk (som Dependabot)                                 | **[Sync →](docs/README.sync.md)**                  |
| 📦 **Samlinger**     | Installer en hel pakke med agenter, skills og instruksjoner på én gang                  | **[Samlinger →](docs/README.collections.md)**      |
| 🧭 **nav-pilot**     | CLI-verktøy og AI-agent som installerer og bruker Nav-tilpasninger i Copilot Chat       | **[nav-pilot →](docs/README.nav-pilot.md)**        |

---

## 🛠️ Applikasjoner

Monorepo med fem applikasjoner + cplt (eget repo):

### cplt — Kernel-level sandbox for AI-agenter

Sandboxer AI-kodingsagenter med OS-primitiver (macOS Seatbelt, Linux Landlock + seccomp-BPF). Blokkerer filsystemtilgang, nettverkstrafikk og credential-exfiltration.

**Repo:** [navikt/cplt](https://github.com/navikt/cplt) · **Docs:** [min-copilot.ansatt.nav.no/cplt](https://min-copilot.ansatt.nav.no/cplt)

```bash
brew install navikt/tap/cplt
```

### My Copilot — Selvbetjeningsportal

Administrer Copilot-abonnement, se bruksstatistikk og utforsk tilpasninger fra verktøykatalogen. Har også offentlige sider for [cplt](https://min-copilot.ansatt.nav.no/cplt), [nav-pilot](https://min-copilot.ansatt.nav.no/nav-pilot) og [kom i gang](https://min-copilot.ansatt.nav.no/kom-i-gang).

**URL:** [min-copilot.ansatt.nav.no](https://min-copilot.ansatt.nav.no)

### Copilot API — Backend for my-copilot

Go-tjeneste som håndterer BigQuery-analyser, GitHub API-operasjoner og seat-administrasjon. Bruker Azure AD On-Behalf-Of (OBO) token exchange for sikker kommunikasjon.

- 11 API-endepunkter for bruksdata, adopsjon, tilpasninger, fakturering og seat-administrasjon
- In-memory cache (1t TTL) for BigQuery-data
- Bakgrunnsinnsamling av metrikker hvert 5. minutt
- Audit logging av alle seat-endringer

**Arkitektur:** Se [ARCHITECTURE.md](./ARCHITECTURE.md)

### Copilot Metrics — BigQuery-datapipeline

Naisjob som henter daglige Copilot-bruksmetrikker fra GitHub API og lagrer i BigQuery.

### MCP Registry — MCP-register

Offentlig register over Nav-godkjente MCP-servere. Implementerer [MCP Registry v0.1-spesifikasjonen](https://github.com/modelcontextprotocol/registry).

**URL:** [mcp-registry.nav.no](https://mcp-registry.nav.no)

#### Organisasjonsoppsett (allerede konfigurert)

Nav har konfigurert MCP-policyen på organisasjonsnivå:

- **MCP servers in Copilot**: Enabled
- **MCP Registry URL**: `https://mcp-registry.nav.no`
- **Policy**: Registry only (kun servere fra registeret kan brukes)

Denne policyen håndheves automatisk for alle med Copilot-sete i navikt-organisasjonen. Enkeltbrukere kan ikke endre policyen.

> **Håndhevelse**: Basert på server name/ID-matching. Lokale servere (som IntelliJ MCP) må ha en oppføring i registeret med ID som matcher nøyaktig det installerte server-ID-et. Se [GitHub docs: MCP allowlist enforcement](https://docs.github.com/en/copilot/reference/mcp-allowlist-enforcement).

#### For IDE-brukere

Registry-servere dukker automatisk opp i MCP-panelet i VS Code og JetBrains. Ingen oppsett per bruker.

#### For Copilot CLI

```bash
# Bla gjennom tilgjengelige servere
curl -s https://mcp-registry.nav.no/v0.1/servers | jq

# Legg til en server
gh copilot mcp add --url https://mcp-onboarding.nav.no/mcp
```

### MCP Onboarding — Agent Readiness

MCP-server for å utforske Nav Copilot-tilpasninger, vurdere agent-readiness og generere AGENTS.md.

**URL:** [mcp-onboarding.nav.no](https://mcp-onboarding.nav.no)

#### Installer

1. Åpne Command Palette i VS Code (`Cmd+Shift+P`)
2. Kjør **MCP: Add Server**
3. Søk etter **Mcp Onboarding** i Nav MCP-registeret
4. Logg inn med GitHub (krever navikt-medlemskap)

#### Bruk i Copilot Chat

```text
List all Nav agents
Search for kafka customizations
Check agent readiness for navikt/fp-sak
Generate AGENTS.md for navikt/fp-sak
Show agent readiness for repos with prefix fp
```

> **Tips:**
>
> - Erstatt `fp-sak` med ditt reponavn i `navikt/`.
> - For `team_readiness`, bruk **repo-prefiks** teamet bruker (f.eks. `fp` for foreldrepenger), ikke fullt teamnavn.

---

## 🏗️ Nav Tech Stack

Tilpasningene dekker Navs kjernestack:

- **Backend**: Kotlin, Ktor, PostgreSQL, Kafka
- **Frontend**: Next.js 16+, React, TypeScript, Aksel Design System
- **Plattform**: Nais (Kubernetes på GCP)
- **Auth**: Azure AD, TokenX, ID-porten, Maskinporten
- **Observability**: Prometheus, Grafana Loki, Tempo (OpenTelemetry)

## 📖 Repository Structure

```plaintext
├── .github/
│   ├── agents/           # Custom GitHub Copilot agents (.agent.md)
│   ├── instructions/     # File-pattern-based coding standards (.instructions.md)
│   ├── prompts/          # Task-specific scaffolding templates (.prompt.md)
│   └── skills/           # Production patterns with bundled resources
├── docs/                 # Detailed documentation for each customization type
│   ├── README.agents.md
│   ├── README.instructions.md
│   ├── README.mcp.md
│   ├── README.prompts.md
│   ├── README.skills.md
│   ├── README.testing.md
│   └── README.collections.md
├── apps/                 # Nav applications
│   ├── copilot-api/      # Go backend API (BigQuery, GitHub API, seat management)
│   ├── copilot-metrics/  # BigQuery data pipeline (Naisjob)
│   ├── mcp-onboarding/   # MCP server for agent readiness
│   ├── mcp-registry/     # MCP server registry
│   └── my-copilot/       # Next.js frontend portal
└── dashboards/           # Grafana dashboard definitions
```

---

## 🤝 Bidra

### Legg til tilpasninger

1. **Agenter**: Legg til `*.agent.md` i `.github/agents/` — se [agent-dokumentasjonen](docs/README.agents.md)
2. **Instruksjoner**: Legg til `*.instructions.md` i `.github/instructions/`
3. **Prompts**: Legg til `*.prompt.md` i `.github/prompts/`
4. **Skills**: Legg til mappe med `SKILL.md` i `.github/skills/`

Kjør `mise check` etter endringer for å validere alt.

### CI og merge queue

Alle pull requests og merge queue-oppføringer kjører [`ci.yaml`](.github/workflows/ci.yaml), som produserer én sjekk: **`ci-ok`**. Dette er den eneste required status check i branch-rulesettet — blir den grønn, kan PR-en merges via køen.

Slik fungerer det:

- Jobben `changes` bruker [dorny/paths-filter](https://github.com/dorny/paths-filter) til å finne hvilke komponenter som er berørt av endringen (samme path-lister som komponent-workflowene bruker). Kun de berørte komponentenes sjekker kjøres — endrer du ingenting relevant, blir `ci-ok` grønn med en gang.
- gitleaks-skann av hele historikken kjører alltid, uavhengig av hvilke filer som er endret.
- `ci-ok` feiler hvis en kjørt sjekk feiler eller avbrytes, og lykkes når alt som trengtes er grønt (hoppede jobber teller som OK).

Komponent-workflowene (`copilot-api.yaml`, `my-copilot.yaml`, osv.) kjører fortsatt på pull requests for PR-preview-deploy til dev, og på push til `main` for deploy til produksjon. De er bevisst *ikke* required checks og kjører ikke i merge-køen — deploys skal ikke skje per køoppføring.

### Unngå å committe hemmeligheter

CI skanner hele historikken med [gitleaks](https://github.com/gitleaks/gitleaks). Vil du fange lekkasjer allerede før commit, installer gitleaks lokalt (`brew install gitleaks`) og legg til en valgfri pre-commit-sjekk:

```bash
gitleaks git --pre-commit --staged    # Skanner kun stagede endringer
```

Falske positiver håndteres i [.gitleaks.toml](.gitleaks.toml).

<details>
<summary>Utvikleroppsett for applikasjonene</summary>

**Forutsetninger:** [mise](https://mise.jdx.dev) og [fnox](https://fnox.jdx.dev)

```bash
mise install          # Installer verktøy
lefthook install      # Aktiver pre-commit og commit-msg hooks
```

Hemmeligheter håndteres med fnox + macOS Keychain — ingen `.env`-filer. Hver app har en `fnox.toml` med nødvendige hemmeligheter:

| Service | Apper | Hemmeligheter |
|---|---|---|
| `copilot-portal` | my-copilot | GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY, GITHUB_APP_INSTALLATION_ID |
| `copilot-jobs` | copilot-adoption, copilot-metrics, mcp-onboarding | GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY, GITHUB_APP_INSTALLATION_ID, SLACK_WEBHOOK_URL |

```bash
cd apps/my-copilot
fnox set GITHUB_APP_ID              # Ber om verdi, lagrer i Keychain
fnox set GITHUB_APP_PRIVATE_KEY
fnox set GITHUB_APP_INSTALLATION_ID
```

Ikke-hemmelig konfig (org-navn, BigQuery-datasett osv.) ligger i `.mise.toml` under `[env]` per app.

**Annen secrets-backend?** `fnox.toml` bruker macOS Keychain som standard, men du kan overstyre med 1Password, GCP Secret Manager osv. i en gitignored `fnox.local.toml`. Se [fnox providers](https://fnox.jdx.dev/providers/).

```bash
cd apps/my-copilot && mise dev      # Starter med hemmeligheter via fnox
```

Se [AGENTS.md](AGENTS.md) for fullstendig utviklerguide.

</details>

---

## 👥 Team

Vedlikeholdes av **Team Copilot** i Nav IT.

---

## 📄 Lisens

[MIT](LICENSE)

---

## 🔗 Ressurser

- [Nais Documentation](https://doc.nais.io)
- [Aksel Design System](https://aksel.Nav.no)
- [Nav GitHub](https://github.com/Navikt)

copilot

copilot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

copilot

copilot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README