Hoe wijzig je de map van de gemini cli?

Google’s open-source Gemini CLI—de terminalgebaseerde AI-agent die Gemini naar je shell brengt—heeft zich sinds de lancering snel ontwikkeld en ondersteunt nu rijke configuratie, projectcontextbestanden (GEMINI.md / .gemini), aangepaste slash-commando’s en workspace-mapbeheer. Het project evolueert actief op GitHub (officiële repo), is in openbare preview met royale quota’s, en wordt geïntegreerd in andere ontwikkeltools (editor-integraties en CI/Actions). Maar naarmate teams opschalen, of wanneer je werkt over schijven of in restrictieve omgevingen (containers, bedrijfslaptops, Cloud Shell, Windows-systemen), kom je al snel bij een praktische vraag: waar slaat Gemini zijn bestanden op, en hoe kun je wijzigen welke mappen Gemini leest en schrijft?

Wat is Gemini CLI?

Gemini CLI is Google’s open-source command-line AI-agent die de kracht van de Gemini-modellen rechtstreeks naar je terminal brengt. Het biedt interactieve agentmogelijkheden voor code-assistentie, bestand- en projectinspectie, het uitvoeren van shellcommando’s (met waarborgen), en het integreren van tools zoals Google Search, Model Context Protocol (MCP)-extensies en mediageneratietools die met Gemini worden meegeleverd. De CLI is bedoeld om lichtgewicht, scriptbaar en uitbreidbaar te zijn; hij is beschikbaar via de officiële repository en verpakt voor eenvoudige installatie.

Waarom de map belangrijk is

Gemini CLI slaat configuratie op (bijvoorbeeld settings.json), systeemprompts of context (GEMINI.md), gecachte credentials, telemetrie-ID’s en andere persistente status in een .gemini-map. Waar die map staat, bepaalt:

• welke instellingen de CLI laadt (globaal vs. projectspecifiek),
• welke “memory”-bestanden de agent zal lezen,
• waar credentials worden gecached (heeft invloed op login-gedrag),
• reproduceerbaarheid tussen machines of in CI wanneer je een aangepaste config-repo wilt gebruiken.

Begrijpen en (indien nodig) aanpassen van de map helpt bij multi-projectworkflows, CI, container-deployments en teams met gecentraliseerde configuratiestores.

Waar slaat Gemini CLI standaard de configuratie op?

Standaard gebruikt de CLI een .gemini-map. Voor de meeste gebruikersinstallaties komt dat neer op ~/.gemini (de .gemini-map in je thuismap). De CLI ondersteunt ook projectniveau .gemini-bestanden (bijv. .gemini/settings.json in de projectroot) die gebruikersinstellingen overschrijven terwijl je vanuit die projectmap werkt. Systeeminstellingen worden, waar van toepassing, gelezen uit OS-specifieke locaties (bijvoorbeeld /etc/ op Linux of %PROGRAMDATA% op Windows). Typische paden:

• Linux / macOS: ~/.gemini/ (bijvoorbeeld /home/alice/.gemini of /Users/alice/.gemini).
• Windows: %USERPROFILE%\.gemini (bijv. C:\Users\Alice\.gemini).
  In .gemini vind je doorgaans settings.json, GEMINI.md, commands/ en lokale caches. De CLI leest ook projectspecifieke .gemini/-mappen (projectroot) voor projectniveau-instellingen.

Deze standaard is belangrijk: historisch is de configuratiemap hard-coded naar .gemini in de thuismap

---

Hoe kan ik de configuratiemap van Gemini CLI wijzigen of omleiden?

Er zijn verschillende praktische manieren — van de eenvoudigste (werk in de gewenste map) tot robuustere (omgevingsvariabelen of filesystem-redirects). Kies een aanpak afhankelijk van of je de runtime-omgeving beheert (lokale dev-machine vs. CI), op welk OS je zit, en of je een tijdelijke of permanente wijziging wilt.

1) Gebruik een .gemini op projectniveau (aanbevolen voor projectspecifieke instellingen)

Als je projectspecifieke instellingen wilt, maak dan een .gemini-submap in je projectroot en plaats settings.json, GEMINI.md en andere projectbestanden daar. Gemini CLI prefereert projectinstellingen wanneer je het start vanuit die projectmap:

your-project/├─ .gemini/│  ├─ settings.json│  └─ GEMINI.md└─ src/

Start gemini terwijl je shell zich in your-project/ bevindt en de CLI zal .gemini-bestanden uit die boom oppikken (het zoekt omhoog om projectcontext te vinden). Dit is de veiligste, expliciete methode voor configuratie per project.

2) Gebruik gedocumenteerde omgevingsvariabelen (indien ondersteund)

De Gemini CLI-codebase en documentatie verwijzen naar verschillende omgevingsvariabelen die gedrag wijzigen. Sommige zijn bedoeld voor systeeminstellingen of speciale bestandoverrides:

• GEMINI_API_KEY, GEMINI_MODEL, enz. worden vaak gebruikt voor authenticatie en modelkeuze.
• Er zijn verwijzingen in de codebase en docs naar variabelen zoals GEMINI_CLI_SYSTEM_SETTINGS_PATH (gebruikt om het pad voor systeeminstellingen te overschrijven) en constants zoals GEMINI_CONFIG_DIR (de standaard .gemini-naam die in code wordt gebruikt). Sommige communityverzoeken en PR’s stellen voor om een GEMINI_CONFIG_DIR-omgevingsvariabele toe te voegen of te honoreren zodat gebruikers de hele configuratiemap kunnen verplaatsen.

Voorbeeld (bash / macOS / Linux):

# Temporary for this shell sessionexport GEMINI_CONFIG_DIR="$HOME/custom_gemini_dir"​# Or override system settings path if your install supports it:export GEMINI_CLI_SYSTEM_SETTINGS_PATH="/etc/my-gemini/system.settings.json"​# Then rungemini

PowerShell (Windows):

$env:GEMINI_CONFIG_DIR = 'C:\Users\you\CustomGemini'gemini

Belangrijke kanttekening: volgens de laatste communitydiscussies en issues is GEMINI_CONFIG_DIR aangevraagd en op plaatsen in de code genoemd — maar platformspecifieke bugs en inconsistente werking (met name op Windows) zijn gemeld. Dat betekent dat omgevingsvariabele-gebaseerde omleiding niet op elk platform of elke release uniform betrouwbaar kan zijn. Controleer de Gemini CLI-releasenotes en repo-issues voor jouw geïnstalleerde versie als je hierop vertrouwt.

3) Voeg mappen toe aan de werkruimte van Gemini binnen een sessie

Als je wilt dat Gemini extra mappen kent (zodat het bestanden als context kan lezen), is er een interactieve /directory-commandoset. Bijvoorbeeld:

/directory add path/to/another/project/directory list

Dit verplaatst de configuratiemap niet, maar laat de agent wel bestanden uit andere mappen opnemen in zijn werkruimtecontext. Dit is nuttig wanneer je wilt dat de agent naar andere repositories verwijst zonder je globale configuratie te wijzigen.

4) Maak een symbolische link of bestandssysteem-bind (praktische workaround)

Als de CLI omgevingsoverrides niet wil accepteren of je een betrouwbare cross-process-oplossing nodig hebt, gebruik dan een filesystem-redirect:

Op Unix/macOS:

# move the original config foldermv ~/.gemini ~/gemini_backup​# create a symlink to your desired locationln -s /path/to/central/gemini-config ~/.gemini

Op Windows (PowerShell met administratorrechten):

# Move the original directoryMove-Item -Path $env:USERPROFILE\.gemini -Destination C:\GeminiConfigBackup​# Create a junction (administrator)New-Item -ItemType Junction -Path $env:USERPROFILE\.gemini -Target C:\CentralGeminiConfig

Deze aanpak dwingt de CLI om uit jouw gewenste locatie te lezen zonder native ondersteuning in de CLI te vereisen. Let op: symlinks/junctions vereisen de juiste bestandsrechten en kunnen zich anders gedragen in container- of Windows-omgevingen. Gebruik met zorg. (Zie “Windows-specifieke opmerkingen” hieronder.)

5) Wijzig de effectieve thuismap voor het proces (container/CI-truc)

Bij gebruik in CI, containers of efemere omgevingen kun je de $HOME (Unix) of %USERPROFILE% (Windows) omgevingsvariabele voor het gemini-proces wijzigen, zodat de standaard ~/.gemini wordt omgezet naar een pad dat jij beheert:

# Run gemini with a custom HOME (bash)HOME=/ci/workspace/you gemini --some-command​# Or in a container DockerfileENV HOME=/app/userRUN mkdir -p /app/user/.geminiCOPY config /app/user/.gemini

Dit is handig voor CI-reproduceerbaarheid, maar let op: het wijzigen van HOME kan andere tools en authenticatiestromen beïnvloeden (bijv. Google OAuth-caches), dus beperk deze techniek tot geïsoleerde containers of procesniveau-wrappers.

Hoe kan ik Gemini CLI installeren en gebruiken via CometAPI?

Kort antwoord: je hebt twee praktische paden — (A) roep Gemini-modellen rechtstreeks aan via CometAPI (aanbevolen en het eenvoudigst), of (B) laat de officiële Gemini CLI met CometAPI praten door ofwel een Gemini-CLI-release te gebruiken die een aangepaste base-URL ondersteunt (sommige releases/PR’s voegen dit toe), of door een kleine lokale proxy te draaien die Gemini-CLI-verzoeken vertaalt naar CometAPI/OpenAI-stijl calls.

Wat is CometAPI?

CometAPI is een API-aggregatie/gateway die honderden third-party modellen (inclusief Google’s Gemini-familie) aanbiedt achter een HTTP-API in OpenAI-stijl. Je schrijft je in, krijgt een bearer-API-sleutel en roept vervolgens endpoints aan zoals https://api.cometapi.com/v1/chat/completions. CometAPI gebruikt standaard bearer-tokens in de Authorization-header.

Waarom CometAPI gebruiken? Het biedt lagere API-prijzen dan de officiële API om integratie te vergemakkelijken. Gemini CLI Installation and Usage Guide:

Hoe kan ik Gemini-modellen rechtstreeks via CometAPI aanroepen? (Aanbevolen)

Als je doel simpelweg is om Gemini-modellen te gebruiken en je strikt geen Gemini CLI-functies nodig hebt, is CometAPI direct aanroepen eenvoudig en betrouwbaar.

export COMET_KEY="sk-xxxx"​curl -s -X POST "https://api.cometapi.com/v1/chat/completions" \  -H "Authorization: Bearer $COMET_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gemini-2.5-pro",    "messages": [      {"role": "system", "content": "You are a helpful assistant."},      {"role": "user", "content": "Summarize the 3 key benefits of unit tests."}    ],    "max_tokens": 300  }' | jq .

Deze directe aanroepen laten je CometAPI integreren in scripts, apps of CI zonder afhankelijk te zijn van Gemini CLI.

Kan ik Gemini CLI CometAPI laten gebruiken?

Sommige versies/PR’s van Gemini CLI voegen omgevingsvariabelen toe om de Gemini API-base-URL te overschrijven. Als jouw geïnstalleerde gemini ondersteunt dat je een aangepaste Gemini-base-URL configureert + een CometAPI-sleutel gebruikt, kun je deze richten op CometAPI en de CometAPI-sleutel instellen als de GEMINI_API_KEY (CLI verwacht een sleutelvariabele met de naam GEMINI_API_KEY voor Gemini API key-auth).

Voorbeeld:

# example env — *check your gemini-cli docs for exact var names*export GEMINI_API_KEY="sk-xxxxx"                    # CometAPI keyexport GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com/v1"  # if supportedgemini   # run the CLI; it will use the configured base URL

Probleemoplossing: veelvoorkomende problemen en oplossingen

Probleem: Gemini ziet geen bestanden in een andere repo

1. Probeer gemini --include-directories /path/to/repo bij het starten. Of in de sessie: /directory add /path/to/repo.
2. Als de repo op een netwerkschijf staat, controleer dan de rechten en dat de CLI-procesgebruiker de bestanden kan lezen.
3. Als je een symlink gebruikte om .gemini te verplaatsen, controleer dan of de CLI de symlink volgt voor GEMINI.md en settings.json (sommige versies volgen bepaalde symlinks niet om veiligheidsredenen).

Probleem: gemini kan ~/.gemini niet aanmaken op Windows (EPERM)

Dit betekent doorgaans dat je proces geen rechten heeft om naar %USERPROFILE% te schrijven. Oplossingen:

• Voer de terminal uit als Administrator of pas maprechten aan.
• Stel een aangepaste configuratielocatie in via een symlink of, indien ondersteund, via een omgevingsvariabele (let op toekomstige ondersteuning voor GEMINI_CONFIG_DIR).

Probleem: cd verandert de werkmap niet in shellmodus

Dit is een erkende issue op sommige platformen. Aanbevolen: voer shellcommando’s buiten het Gemini CLI-proces uit of voeg mappen toe via /directory add.

Probleem: CometAPI-modelnamen komen niet overeen met wat ik verwacht

Roep het /v1/models-endpoint aan en inspecteer de JSON. Model-ID’s bevatten vaak exacte variantstrings (bijv. gemini-2.5-flash-preview-04-17). Gebruik de exacte string in je request.

Conclusie

Het standaardontwerp van Gemini CLI geeft de voorkeur aan verstandig, eenvoudig te ontdekken gedrag: een globale ~/.gemini voor gebruikersniveau-defaults en een project-.gemini voor repo-specifieke overrides. De community stuurt aan op meer native configureerbaarheid (expliciete omgevingsvariabelen of flags) om de tool vriendelijker te maken voor multi-user-, container- en enterprise-omgevingen.

Hoe je de Gemini CLI-map wijzigt:

Overzicht: Gemini CLI slaat gebruikersbrede configuratie- en contextbestanden op in een .gemini-map (meestal ~/.gemini). Je kunt beïnvloeden welke map de CLI gebruikt door (1) te vertrouwen op een .gemini op projectniveau in de huidige werkmap, (2) omgevingsvariabelen of CLI-opties te gebruiken waar ondersteund, (3) werkruimtemappen toe te voegen binnen een interactieve sessie, of (4) filesystemtechnieken (symlinks, bind mounts, of het wijzigen van home/profile-variabelen) te gebruiken wanneer native opties ontbreken.

Om te beginnen, verken de mogelijkheden van Gemini-modellen (zoals Gemini 3 Pro) in de Playground en raadpleeg de API guide voor gedetailleerde instructies. Zorg ervoor dat je bent ingelogd bij CometAPI en de API-sleutel hebt verkregen voordat je toegang vraagt. CometAPI biedt een prijs die veel lager is dan de officiële prijs om integratie te helpen.

Klaar om te beginnen?→ Gratis proef van Gemini-modellen !