k8s-agent-sandbox

Manage Kubernetes Sandbox CRDs and Python SDK for isolated AI agent execution.

Updated Dec 21, 2025
One-click install
npx skills add https://github.com/khirotaka/cc-plugins --skill k8s-agent-sandbox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-agent-sandbox
Source: https://github.com/khirotaka/cc-plugins/tree/main/plugins/agent-sandbox-docs/skills
Command: npx skills add https://github.com/khirotaka/cc-plugins --skill k8s-agent-sandbox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive documentation for Kubernetes Agent Sandbox, including how to understand and use the Sandbox CRD (Sandbox, SandboxTemplate, SandboxClaim, SandboxWarmPool) and the Python SDK (SandboxClient, SandboxRouter, ComputerUseExtension). It also covers network policies, security configurations, and practical implementation examples to help teams automate sandboxed AI agent execution environments.

Core Features & Use Cases

  • CRD Reference & Architecture: Detailed descriptions of core CRDs, their fields, status, and interactions.
  • Python SDK Guidance: Overview of SandboxClient, SandboxRouter, and extensions to automate sandbox operations.
  • Implementation Examples: Real-world usage patterns and references for deploying and using sandbox templates, claims, and warm pools.

Quick Start

Start by exploring the CRD references in the SKILL to understand how to deploy a SandboxTemplate and use the Python SDK. Use a command like SandboxClient(template_name="python-sandbox-template") to begin interacting with a sandbox.

Frequently Asked Questions about k8s-agent-sandbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I securely execute AI agents in isolated Kubernetes environments?

Kubernetes Agent Sandbox provides CRD-based isolation for AI agent execution using network policies and runtime sandboxing (gVisor or Kata). Deploy a SandboxTemplate and use SandboxClient to provision and manage isolated Pod environments with automatic lifecycle handling.

What are Sandbox CRDs and how do they work together?

Sandbox CRDs (Sandbox, SandboxTemplate, SandboxClaim, SandboxWarmPool) define templates, claims, and warm pools for on-demand sandbox provisioning. SandboxTemplate defines the blueprint; Sandbox represents a runtime instance; SandboxClaim requests access; SandboxWarmPool pre-provisions instances for faster deployment.

Can I automate sandbox provisioning and management with Python?

Yes. The Python SDK includes SandboxClient for direct sandbox interaction and SandboxRouter for on-demand provisioning and routing. Use SandboxClient(template_name="python-sandbox-template") to programmatically create and manage sandbox instances.

What connection modes are available for accessing sandboxes?

Agent Sandbox supports three connection modes: Tunnel (proxied connection), Gateway (ingress-based access), and Direct (point-to-point connection). Choose based on network topology, security requirements, and latency constraints for your deployment context.

How do network policies enforce isolation in sandboxes?

Network policies restrict traffic between sandbox instances and external services. Agent Sandbox applies policy-based isolation automatically through CRD configuration, preventing unauthorized inter-pod communication and enforcing egress/ingress rules at the Kubernetes network layer.

Does this support multiple runtime isolation technologies?

Yes. Agent Sandbox supports both gVisor and Kata Containers as runtime isolation options. Select your preferred runtime when defining the SandboxTemplate to balance between container efficiency and security isolation level.