AI agents

Agent sandboxes for local Google Cloud

Pick the guide for your job: setting up your coding agent, testing one service locally, automating a workflow, comparing options, looking up a term, or following a demo.

AI onboarding Compatibility Docs

Agent setup guides

Claude Code sandbox

Claude Code local GCP sandbox

Give Claude Code a credentialless Google Cloud sandbox: LocalCloud in Docker, localhost SDK endpoints, copyable prompts, and a real-GCP validation step.

Terminal-first setup using Docker and localhost endpoints.
Docker image: agentcloud/localcloud:latest.

Codex-style CLI sandbox

Codex CLI local GCP sandbox

Use LocalCloud as a local Google Cloud target for Codex-style terminal agents, with safe prompts, localhost SDK endpoints, and no cloud credentials.

Works with terminal agents that can run Docker and project tests.
Keep setup instructions in prompt text because Codex-style CLIs differ by distribution.

Cursor sandbox

Cursor local GCP sandbox

Point Cursor agent workflows at LocalCloud to test Google Cloud code locally with Docker, repo-aware prompts, and a clear production validation step.

Best for workspace-aware edits plus an integrated terminal test loop.
Keep emulator env vars in the terminal/session running tests.

Gemini CLI sandbox

Gemini CLI local GCP sandbox

Run Gemini CLI-style terminal workflows against LocalCloud to test Google Cloud SDK code locally, with setup steps and no-credential guardrails.

Use shell-visible emulator variables for SDK tests.
Model or CLI login is separate from GCP runtime credentials.

Browse by section

Service guides

Each service that runs locally links its agent testing page with prompts and a local check.
Workflows

GitHub Actions, Terraform and CI integration testing.
Comparisons

LocalCloud next to LocalStack, Google's emulators and hosted agent sandboxes.
Glossary

Plain definitions of agent and local cloud terms.
Blog

Demo posts and announcements.