Gemini Local
geminilocal runs Google's Gemini CLI on the same machine as Paperclip. Use it when you want a local agent with session resume, configurable sandboxing, and Paperclip skills injected into Gemini's ski…
Gemini Local
geminilocal runs Google's Gemini CLI on the same machine as Paperclip. Use it when you want a local agent with session resume, configurable sandboxing, and Paperclip skills injected into Gemini's skills directory.
---
When To Use
Gemini CLI is installed on the host machine. You want the agent to resume the same Gemini session across heartbeats. You want Paperclip to manage skills locally without polluting the project directory. You want an adapter that can authenticate through API keys or Gemini CLI login.
When Not To Use
The agent runs behind a webhook or remote API. Use HTTP (/docs/adapters/http). You only need a command runner or script. Use Process (/docs/adapters/process). Gemini CLI is not installed or cannot reach the target working directory.
---
Common Fields
| Field | Required | Notes | |---|---:|---| | cwd | no | Absolute working directory for the agent. Recommended in practice. If omitted, the adapter falls back to the current process working directory. Paperclip creates the path when permissions allow. | | model | no | Gemini model id. Defaults to auto. Common choices include gemini-2.5-pro and gemini-2.5-flash. | | promptTemplate | no | Prompt template used for the run. | | instructionsFilePath | no | Markdown instructions file prepended to the prompt. | | sandbox | no | Enables Gemini sandbox mode. The adapter otherwise passes --sandbox=none. | | yolo | no | Convenience toggle for unattended approval mode. | | approvalMode | no | Advanced control for Gemini approval mode. | | command | no | Defaults to gemini. | | extraArgs | no | Extra CLI arguments appended to the Gemini invocation. | | env | no | Environment variables passed to the runtime. Secret refs are supported. | | helloProbeTimeoutSec | no | Timeout for the readiness probe. | | timeoutSec | no | Run timeout in seconds. 0 means no timeout. | | graceSec | no | Grace period before a forced stop. |