Run Google Gemini CLI agents on your cloud VMs
Google's Gemini CLI brings Gemini's multimodal capabilities to the command line for coding tasks. SAM orchestrates Gemini CLI on your infrastructure, giving you access to Google's most capable models in isolated cloud environments.
Why use Gemini CLI with SAM
Multimodal Coding
Gemini CLI can understand images, diagrams, and screenshots alongside code — useful for UI implementation tasks.
Gemini 2.5 Models
Access Gemini 2.5 Pro and Flash models for different cost/performance tradeoffs.
Large Context Windows
Gemini models support massive context windows, ideal for understanding large codebases.
Google API Key Auth
Simple API key authentication — add your Gemini API key and start running agents.
Get started in four steps
Add Your API Key
Enter your Google Gemini API key in SAM settings.
Select Gemini CLI
Choose Gemini CLI as the agent for your project.
Describe Your Task
Submit a task with a natural language description of what you need built.
Agent Executes
SAM provisions a VM, builds the devcontainer, installs Gemini CLI, and runs your task.
What you can build
UI implementation from designs
Upload mockups and screenshots — Gemini CLI's multimodal capabilities let it implement UI from visual references.
Large codebase analysis
Use Gemini's massive context window to analyze and refactor large codebases in a single session.
Cross-language projects
Gemini handles polyglot codebases well — ideal for projects mixing TypeScript, Python, Go, and other languages.
Frequently asked questions
Which Gemini models are supported?
SAM supports Gemini 2.5 Pro, Gemini 2.5 Flash, and Gemini 2.0 Flash. Configure the model in your project settings.
Is Gemini CLI free to use?
Gemini CLI requires a Google Gemini API key. Google offers free tier usage with rate limits. SAM itself doesn't charge extra for using Gemini CLI.
Can Gemini CLI work with devcontainers?
Yes — Gemini CLI runs inside your repo's devcontainer on the provisioned VM, with full access to your project's tools and dependencies.
Start running Gemini CLI on your infrastructure
Self-host on Cloudflare's free tier. Bring your own cloud. Your agents, your code.