initial commit

docs/modules/home/gemini-cli.md

@@ -0,0 +1,65 @@
+# Gemini CLI
+
+An open-source AI agent that brings the power of Gemini directly into your terminal.
+
+View the [*synix* Home Manager module on Forgejo](https://git.sid.ovh/sid/synix/tree/master/modules/home/gemini-cli).
+
+## References
+
+- [GitHub](https://github.com/google-gemini/gemini-cli)
+- [CLI Docs](https://github.com/google-gemini/gemini-cli/tree/main/docs/cli)
+
+## Setup
+
+The package must be set by you. Easiest option is to use the synix overlay:
+
+```nix
+{ inputs, pkgs, ... }:
+
+{
+  imports = [
+    inputs.synix.homeModules.gemini-cli
+  ];
+
+  programs.gemini-cli = {
+    enable = true;
+    package = pkgs.synix.gemini-cli;
+  };
+}
+```
+
+Gemini CLI reads environment variables, such as your API key, from `~/.gemini/.env`. You can manage it with sops-nix:
+
+```nix
+{ config, ... }:
+
+{
+  sops.secrets.gemini-api-key = { };
+  sops.templates.gemini-cli-env = {
+    content = ''
+      GEMINI_API_KEY=${config.sops.placeholder.gemini-api-key}
+    '';
+    path = config.home.homeDirectory + "/.gemini/.env";
+  };
+}
+```
+
+Set `gemini-api-key` in your `secrets.yaml`:
+
+> Replace `abc123` with your Gemini API key.
+
+```yaml
+gemini-api-key: abc123
+```
+
+## Troubleshooting
+
+These are some common warnings and errors you might encounter when using Gemini CLI:
+
+### Error saving user settings file
+
+```
+Error saving user settings file: Error: EROFS: read-only file system, open '/home/you/.gemini/settings.json'
+```
+
+This is intended behavior.