🗂️ Terug naar start
⚙️🗂️ Google Start

Gemini CLI: your open-source AI agent
Gemini CLI op GitHub
Gemini CLI documentatie op GitHub✨
Gemini CLI BLOG documentatie✨
Gemini CLI Configuration
Gemini Code Assist Use agentic chat as a pair programmer

Met de Google Gemini Command Line Interface (CLI) kun je razendsnel werken met de slimme Gemini-modellen. Handig als je een beetje technisch bent, of je nu developer, data-analist of gewoon nieuwsgierig bent naar AI. In deze korte gids laat ik je stap voor stap zien hoe je het installeert en je eerste query draait. Zo kun je meteen zelf ervaren wat je allemaal met AI in je workflow kunt doen.

De Gemini CLI draait alleen als je Node.js (versie 18 of hoger) op je computer hebt staan.

1. Open even je terminal (dus Command Prompt, PowerShell of Windows Terminal). Typ node -v in en druk op Enter. Zie je een versienummer dat begint met v20. of hoger? Top, dan zit je goed en kun je door naar stap
2. Krijg je een foutmelding of zie je een lager nummer, dan moet je eerst even de nieuwste “LTS”-versie van Node.js downloaden van
   • de officiële nodejs website.

Blijf in je terminal en voer dit commando uit om Gemini global te installeren zodat het van iedere locatie op je computer is op te starten:

npm install -g @google/gemini-cli

Druk op Enter. Waarschijnlijk vraagt hij de eerste keer om toestemming om de tool te installeren en te draaien. Typ gewoon y en druk weer op Enter.

Controleer en installeer nieuwere versie op de zelfde manier als installeren. Voer dit dus regelmatig uit:

npm install -g @google/gemini-cli

Je krijgt dan een paar vragen, zoals inloggen met je Google-account, en je kunt een kleurenthema kiezen. De instructies op je scherm volgen.

Klaar? Dan kun je voortaan altijd simpelweg gemini intypen in je terminal om de CLI te starten.

Gemini CLI Configuration

De configuratie wordt toegepast in de volgende volgorde van prioriteit (lagere nummers worden overschreven door hogere nummers):

1. Standaardwaarden: Vaste, standaardinstellingen binnen de applicatie.
2. Gebruikersinstellingenbestand: Algemene instellingen voor de huidige gebruiker.
3. Projectinstellingenbestand: Projectspecifieke instellingen.
4. Omgevingsvariabelen: Systeembrede of sessie-specifieke variabelen, mogelijk geladen vanuit `.env`-bestanden.
5. Command-line argumenten: Waarden die worden meegegeven bij het starten van de CLI (command-line interface).

Er zijn dus meerdere soorten instructies mee te geven dan die hieronder beschreven staan, deze zijn te vinden op de volgende pagina:
Gemini CLI Configuration

Je kunt instructies aan de Gemini CLI meegeven door een markdown bestand (.md) aan te maken met die instructies en iedere keer als je Gemini CLI opstart naar dat bestand te wijzen in de prompt. Dat bestand is dan een soort van system prompt. Je kunt dus verschillende instructie bestanden (profielen) voor de CLI aanmaken.

1. Maak een tekstbestand: Maak ergens op je computer een eenvoudig tekstbestand, bijvoorbeeld gem_algemeen_profiel.md.
2. Schrijf je instructies: Open het bestand en schrijf alle algemene regels, de persona die Gemini moet aannemen, of de context die je wilt meegeven.

Simpel voorbeeld van een gem_algemeen_profiel.md bestand:

# Mijn algemene instructies voor Gemini

1.  Antwoord altijd in het Nederlands.
2.  Spreek me aan met 'Wel edele heer :)'.
3.  Gedraag je als een expert op het gebied van softwareontwikkeling en projectmanagement.
4.  Geef altijd eerst een samenvatting, gevolgd door een gedetailleerd antwoord in stappen.
5.  Gebruik Markdown voor de opmaak van code en lijsten.

Gebruik markdown tekst

Om het script aan het begin van een nieuwe Gemini sessie te laden in de CLI gebruik je het volledige pad (path) naar het betreffende bestand. Dus als dit het pad is naar het bestand “C:\Users\31628\a3dpython\a3d_ai\GeminiBestanden\instructies\gem_algemeen_profiel.md” Begin dan je nieuwe Gemini sessie met:

Lees mijn instructies in @"C:\Users\31628\a3dpython\a3d_ai\GeminiBestanden\instructies\gem_algemeen_profiel.md"
en pas deze toe op ons gesprek. Mijn eerste vraag is...

⚠️ Zet het te gebruiken pad altijd tussen aanhalingstekens

Naast deze manier om te verwijzen naar een instructie bestand op een andere locatie (de globale manier) is er een tweede manier om instructies automatisch in te laten lezen bij het opstarten van Gemini in een bepaalde map. Gemini leest dan het GEMINI.md bestand automatisch in als er een GEMINI.md bestand in de betreffende map staat. Zie hieronder:

📄 GEMINI.md
Je kunt map gerelateerde instructies plaatsen in een GEMINI.md bestand in de root van je project (het project waarin je Gemini opstart). Gemini leest de instructie in dat bestand automatisch in dit in tegenstelling tot eerder beschreven methode zoals hierboven beschreven. Dit is dus een meer lokale methode die per map werkt.

🔸 BV: Je start een project in de map C:\E-commercePlatform
🔸 Je plaats in die map een GEMINI.md bestand.
Voorbeeld inhoud van C:\E-commercePlatform\GEMINI.md:

# Project: E-commerce Platform

## Context
- React frontend met TypeScript
- Node.js backend met Express
- MongoDB database
- Microservices architectuur

## Standaarden
- Gebruik functionele componenten
- Implementeer goede foutafhandeling
- Volg REST API conventies
- Voeg uitgebreide tests toe

Als je Gemini nu opstart in de map C:\E-commercePlatform zal dit bestand altijd automatisch worden ingelezen daar Gemini.

meer over de Gemini CLI Configuratie / het geven van instructies

De .gemini/ map in een project dat gebruikmaakt van de Gemini CLI is bedoeld voor project specifieke configuratie en instellingen die door Gemini CLI worden gebruikt. Dit maakt het mogelijk om het gedrag van Gemini CLI aan te passen aan de wensen en eisen van een project.

Wat kun je in de .gemini/ map plaatsen?
In deze map kun je onder andere de volgende bestanden kwijt:
🔸 configuratiebestanden zoals config.yaml of settings.json. Deze bevatten instellingen die bepalen hoe Gemini CLI zich gedraagt binnen jouw project, zoals voorkeuren voor de AI-assistent, toegestane tools, of project-specifieke parameters.
🔸 styleguides zoals styleguide.md. Hiermee kun je richtlijnen voor code-stijl of documentatie vastleggen, zodat Gemini CLI deze kan gebruiken bij het genereren of aanpassen van code en documentatie.
🔸 extensies of plug-ins. Als je eigen uitbreidingen of scripts hebt die je wilt laten uitvoeren door Gemini CLI, kunnen deze ook in deze map worden geplaatst.
🔸 andere Gemini-specifieke metadata. Denk aan bestanden die sessie-informatie, geheugen, of voorkeuren voor het project opslaan.

Het bestand GEMINI.md hoort inderdaad in de root van je project te staan, niet in de .gemini/ map. Dit is de standaardplek waar Gemini CLI zoekt naar projectcontext en instructies.

GEMINI.md - Root van het project

• Beschrijft de projectcontext, doelen, architectuur, teamafspraken, code-standaarden en voorkeuren.
• Wordt gebruikt als een soort “AI-geheugen” voor het project: de AI gebruikt dit bestand om antwoorden te personaliseren en consistent te houden.
• Kan handmatig of automatisch door Gemini CLI worden bijgewerkt.

config.yaml of settings.json - .gemini/ map

• Bevat technische configuratie voor Gemini CLI zelf, zoals welke tools zijn toegestaan, tokens, API-instellingen, en andere CLI-specifieke parameters.
• Stuurt het gedrag van de CLI aan, niet de inhoudelijke AI-context.
• Wordt meestal in de .gemini/ map geplaatst

De bestanden config.yaml (of .gemini.yml) en settings.json bevatten technische configuratiegegevens voor de Gemini CLI. Ze bepalen hoe de CLI zich gedraagt binnen jouw project of omgeving. Hieronder vind je typische gegevens en concrete voorbeelden.

Veelvoorkomende instellingen:
🔸 Modelkeuze: Geef aan welk AI-model standaard gebruikt moet worden.
🔸 Contextbestanden: Bepaal welke bestanden of mappen Gemini bij analyses moet betrekken.
🔸 Uitsluitingspatronen: Geef aan welke bestanden/mappen genegeerd moeten worden (zoals node_modules).
🔸 Output-voorkeuren: Stel het gewenste uitvoerformaat in (bijv. markdown).
🔸 Tokens/context window: Stel het maximum aantal tokens in voor AI-antwoorden.
🔸 Custom instructies: Voeg extra richtlijnen toe voor de AI binnen dit project.
🔸 MCP Servers: Configureer externe tools of servers die Gemini kan gebruiken.
🔸 Omgevingsvariabelen: Stel variabelen in voor tools of servers die door Gemini worden aangeroepen.

Voorbeeld config.yaml of .gemini.aml

model: gemini-2.5-pro
context-files:
  - 'src/**/*.ts'
  - 'docs/**/*.md'
exclude-patterns:
  - 'node_modules'
  - '*.log'
output-format: markdown
max-tokens: 100000
custom-instructions: |
  Dit is een TypeScript React project.
  Volg moderne React-patronen en hooks.
  Voeg uitgebreide foutafhandeling toe.

Dit voorbeeld specificeert het model, welke bestanden worden meegenomen, wat wordt uitgesloten, het uitvoerformaat, het maximum aantal tokens, en extra instructies voor de AI

Voorbeeld settings.json

{
  "model": "gemini-2.5-pro",
  "outputFormat": "markdown",
  "maxTokens": 100000,
  "mcpServers": {
    "pythonTools": {
      "command": "python",
      "args": ["-m", "my_mcp_server", "--port", "8080"],
      "cwd": "./mcp-servers/python",
      "env": {
        "DATABASE_URL": "$DB_CONNECTION_STRING",
        "API_KEY": "${EXTERNAL_API_KEY}"
      },
      "timeout": 15000
    }
  }
}

Hier configureer je niet alleen het model en uitvoer, maar ook een externe MCP-server die door Gemini kan worden gebruikt, inclusief commando, argumenten, werkomgeving, omgevingsvariabelen en timeout.

Tips for getting started:

1. Geordende lijstAsk questions, edit files, or run commands.
2. Be specific for the best results.
3. Create GEMINI.md files to customize your interactions with Gemini.
4. /help for more information.

Add context: Use @ to specify files for context (e.g., @src/myFile.ts) to target specific files or folders.
Shell mode: Execute shell commands via ! (e.g., !npm run start) or use natural language (e.g. start server).

• /help - for help on gemini-cli
• /docs - open full Gemini CLI documentation in your browser
• /clear - clear the screen and conversation history
• /theme - change the theme
• /auth - change the auth method
• /editor - set external editor preference
• /privacy - display the privacy notice
• /stats - check session stats. Usage: /stats [model|tools]
• /mcp - list configured MCP servers and tools
• /memory - manage memory. Usage: /memory <show|refresh|add> [text for add]
• /tools - list available Gemini CLI tools
• /about - show version info
• /bug - submit a bug report
• /chat - Manage conversation history. Usage: /chat <list|save|resume> [tag]
• /quit - exit the cli
• /compress - Compresses the context by replacing it with a summary.
• ! - shell command

• Enter - Send message
• Ctrl+Enter - New line
• Up/Down - Cycle through your prompt history
• Alt+Left/Right - Jump through words in the input
• Esc - Cancel operation
• Ctrl+C - Quit application

Gemini CLI Configuration

Start: Documentatie
Gemini CLI Configuration