Glossary

AI agent sandbox

A constrained environment where an AI coding agent can run commands, write code, and verify behavior without causing unwanted external side effects.

Fact

LocalCloud is a GCP API sandbox, not a universal shell sandbox.

Fact

Hosted sandboxes and LocalCloud can be complementary.

Definition

What AI agent sandbox means here

A constrained environment where an AI coding agent can run commands, write code, and verify behavior without causing unwanted external side effects.

  • LocalCloud is a GCP API sandbox, not a universal shell sandbox.
  • Hosted sandboxes and LocalCloud can be complementary.
LocalCloud boundary

How to use the term safely

In LocalCloud content, this term should not imply production replacement, legal permission, hidden credentials, or complete cloud parity. It describes a bounded local-development workflow that still needs license review and release validation against real Google Cloud.

Limitations

Use the sandbox deliberately

  • Permitted workflows use local endpoint values and should stop rather than fall back to real Google Cloud or real credentials. The Public Preview License permits individuals and organizations, including for-profit companies, to use LocalCloud for non-production internal development, testing, CI, evaluation, and pilots.
  • LocalCloud emulates bounded local development workflows. Validate application behavior against real Google Cloud before production deployment.
  • Before production deployment, unset LocalCloud emulator environment variables and validate behavior against real Google Cloud.
Next routes

Keep the agent on the supported path

  • Agent routes — Agent sandbox entry points.
  • Compatibility — Service support boundaries.
  • Compatibility matrix — Check current support boundaries before relying on a local-only test.
  • Service catalog — Review every LocalCloud service, endpoint, and limitation.
  • SDK examples — Use standard Google Cloud SDKs pointed at localhost.
  • Seed data — Load deterministic fixtures for repeatable agent and CI runs.