GeminiCliSdk.CLI (gemini_cli_sdk v0.2.0)

Copy Markdown View Source

Resolves the Gemini CLI binary location through the shared CliSubprocessCore.ProviderCLI policy.

Resolution order:

  1. GEMINI_CLI_PATH environment variable (explicit path)
  2. gemini on system PATH (e.g. globally installed via npm)
  3. npm global bin directory (npm prefix -g/bin/gemini)
  4. npx fallback — runs npx --yes --package @google/gemini-cli gemini

Set GEMINI_NO_NPX=1 to disable the npx fallback.

Summary

Functions

command_args(spec, args)
resolve(execution_surface \\ nil)
resolve!(execution_surface \\ nil)

Functions

command_args(spec, args)

@spec command_args(CliSubprocessCore.CommandSpec.t(), [String.t()]) :: [String.t()]

resolve(execution_surface \\ nil)

@spec resolve(CliSubprocessCore.ExecutionSurface.t() | map() | keyword() | nil) ::
  {:ok, CliSubprocessCore.CommandSpec.t()} | {:error, GeminiCliSdk.Error.t()}

resolve!(execution_surface \\ nil)

@spec resolve!(CliSubprocessCore.ExecutionSurface.t() | map() | keyword() | nil) ::
  CliSubprocessCore.CommandSpec.t()