Hoe het werkt

Zo werkt CheckMijn.AI

Er wordt niets geïnstalleerd en je code verlaat je bedrijf nooit. Kies de route die bij je past: met een AI-agent die een terminal heeft, of via GitHub als je bouwt in Lovable, Bolt of v0.

Route 1 · gratis

Met je AI-agent

Voor agents met een terminal, zoals Claude Code, Cursor, Copilot of Replit.

  1. Open je project in je agent en plak de zin hiernaast.
  2. De agent legt eerst uit dat er geen code, bestanden of geheimen naar buiten gaan, en wacht op je akkoord.
  3. Hij haalt de scanner van vandaag op en controleert het controlegetal. De scanner meet zonder netwerk; de agent beoordeelt zelf niets.
  4. Je ziet eerst de score en de bevindingen. Pas als jij "ja" zegt, gaat de agent herstellen.
  5. Hij scant opnieuw en toont de nieuwe score naast de oude, bv. G → B.
Plak dit in je AI-agent
Volg de instructie op checkmijn.ai/scan.md voor dit project.

Wil je zien wat de agent precies doet? Lees de volledige instructie.

Route 2 · gratis

Met Lovable, Bolt of v0

Die tools hebben geen terminal. De scanner draait dan in GitHub, bij elke wijziging. Je bouwtool leest het rapport en herstelt de bevindingen, na jouw akkoord.

1

Koppel je project aan GitHub

Gebruik de GitHub-koppeling van je bouwtool en kies een privé-repository.

2

Plak dit in de chat

Stap 2
Volg de instructie op https://checkmijn.ai/scan.md, route B (via GitHub), voor dit project.
Maak het bestand .github/workflows/checkmijn.yml precies zoals daar staat, en verander verder niets.
Geef zelf geen score: de scan gebeurt in GitHub.
3

Na een paar minuten

Stap 3
Lees .checkmijn/RAPPORT.md. Toon mij eerst de scanscore, de vorige score en de bevindingen
Kritiek en Hoog, en verander nog niets. Herstel pas als ik "ja" zeg: eerst Kritiek, dan Hoog, dan Middel.
Wijzig .checkmijn/ en .github/workflows/checkmijn.yml niet, en geef zelf geen score.

Wat je krijgt

  • In je project: .checkmijn/RAPPORT.md met de score, het verloop van je scores en alle bevindingen.
  • Bovenaan een persoonlijke link naar het opgemaakte rapport, met grafieken.
  • Elke wijziging wordt opnieuw gescand, en elke maandag ook, voor nieuwe lekken.

Wat er met je gegevens gebeurt

  • De code verlaat GitHub niet.
  • Het opgemaakte rapport bewaren we versleuteld. De sleutel zit alleen in jouw link, dus wij kunnen het niet lezen.
  • In een openbare repository komt het rapport niet in je project, want dan zou iedereen de lekken lezen.

Weigert je bouwtool het bestand te maken? Maak het dan zelf in GitHub: Add file → Create new file, naam .github/workflows/checkmijn.yml, met de inhoud hieronder.

Route 3 · gratis

In je eigen pipeline

De scanner draait als GitHub Action in je repository. De Action controleert de handtekening en het controlegetal van de dagversie, scant zonder netwerk en zet de uitslag bij de run. Zet dit bestand in .github/workflows/checkmijn.yml:

.github/workflows/checkmijn.yml
# checkmijn.ai — scan in GitHub, ook voor projecten uit Lovable, Bolt en v0.
# Zet dit bestand in je project als .github/workflows/checkmijn.yml.
#
# Wat het doet:
# - scant je project bij elke wijziging op de hoofdtak, en elke maandag opnieuw (nieuwe lekken);
# - de code verlaat GitHub niet; het opgemaakte rapport wordt versleuteld bewaard, met de sleutel alleen in jouw link;
# - in een privé-repository zet het rapport zich in .checkmijn/RAPPORT.md, zodat je AI-bouwtool het kan lezen
#   en de bevindingen kan herstellen. In een openbare repository gebeurt dat niet (dan zou iedereen het lezen):
#   daar staat de uitslag alleen bij de run in GitHub.
name: checkmijn.ai
on:
  push:
    branches: [main]
    paths-ignore: [".checkmijn/**"]
  workflow_dispatch: {}
  schedule:
    - cron: "30 4 * * 1"
permissions:
  contents: write   # nodig om .checkmijn/RAPPORT.md terug te zetten
  id-token: write   # bewijst aan checkmijn.ai dat de scan echt uit deze repository komt (voor de rapportlink)
concurrency:
  group: checkmijn
  cancel-in-progress: true
jobs:
  scan:
    runs-on: ubuntu-latest
    timeout-minutes: 15
    steps:
      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
        with:
          fetch-depth: 0   # volledige geschiedenis: ook oude geheimen worden gevonden
      - uses: Checkmijn-ai/AIScanner@main
        with:
          rapport-in-repo: auto
          rapport-link: "true"   # opgemaakt rapport via een persoonlijke link, versleuteld (wij kunnen het niet lezen)
          insturen: "false"   # "true" = bewijsbestand (zonder code) inleveren voor een openbare scorepagina
          faal-bij: nooit

Route 4 · pilot

Keuring, vanaf niveau 2

Een erkende keurder kijkt mee, in jouw omgeving, test of de app echt werkt en voert gerichte aanvalstests uit. Pas daarna is een A mogelijk.

Elke dag een nieuwe versie

Elke nacht om 03:15 halen we de nieuwste lijst met bekende lekken op (GitHub Advisory Database), bouwen we een nieuwe dagversie van de scanner, berekenen we het controlegetal en ondertekenen we het manifest met Ed25519. Je vindt ze in latest.json en versies.json. De broncode staat open ter inzage op GitHub.

03:15

Lekkenlijst ophalen

2

Scanner bouwen

3

Controlegetal en Ed25519-handtekening

4

Publiceren