https://github.com/derailed-dash/gemini-keychain-fix
Fixes 'Keychain is not available' errors in WSL, Docker, and other headless Linux environments. For me, it helps me resolve installing the Nano Banana extension into Gemini CLI in WSL.
https://github.com/derailed-dash/gemini-keychain-fix
agent-skill gemini-cli gemini-cli-extension gemini-cli-extensions keychain skill
Last synced: 3 months ago
JSON representation
Fixes 'Keychain is not available' errors in WSL, Docker, and other headless Linux environments. For me, it helps me resolve installing the Nano Banana extension into Gemini CLI in WSL.
- Host: GitHub
- URL: https://github.com/derailed-dash/gemini-keychain-fix
- Owner: derailed-dash
- Created: 2026-03-08T00:14:53.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-09T09:59:02.000Z (3 months ago)
- Last Synced: 2026-03-09T14:32:44.774Z (3 months ago)
- Topics: agent-skill, gemini-cli, gemini-cli-extension, gemini-cli-extensions, keychain, skill
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Gemini CLI Extension: Keychain Fix
This extension fixes "Keychain is not available" errors when running Gemini CLI or NotebookLM (`nlm`) in headless Linux environments like WSL (Ubuntu), Docker containers, or remote SSH sessions.
This is useful to temporarily work around a bug in Gemini CLI that requires a GUI keychain service to be available. This is expected to be fixed in Gemini CLI shortly. This is expected to be fixed in Gemini CLI shortly.
## ⚠️ IMPORTANT SECURITY WARNING
**This fix replaces encrypted OS-level storage (Keychain) with plain text file storage.**
While the files are protected by standard Linux file permissions (readable only by your user), they are **not encrypted**. Use this only in trusted environments where you have full control over the host machine.
## How to use
Install directly via URL (once published):
```bash
gemini extensions install https://github.com/derailed-dash/gemini-keychain-fix
```
After installation, the agent will have the **`gemini-keychain-fix`** skill active. If you encounter a "Keychain is not available" error, simply ask the agent to fix it, and it will use the skill to configure the correct backends.
## Contents
* **gemini-keychain-fix skill:** Procedural expertise for configuring Python (`keyrings.alt`) and Node.js (`.env`) backends.
* **Auto-fix capability:** The agent can now automatically diagnose and repair these issues in your environment.