agentuity-cli-cloud-sandbox-run

agentuity 的头像作者 agentuity

在沙箱中运行一次性命令(创建、执行、销毁)。需要身份验证。用于Agentuity云平台操作

📖 中文导读:在沙箱中运行一次性命令(创建、执行、销毁)。需要身份验证。用于Agentuity云平台操作 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: agentuity-cli-cloud-sandbox-run description: "Run a one-shot command in a sandbox (creates, executes, destroys). Requires authentication. Use for Agentuity cloud platform operations" version: "0.0.110" license: Apache-2.0 allowed-tools: "Bash(agentuity:*)" argument-hint: "<command...>" metadata: command: "agentuity cloud sandbox run" tags: "slow requires-auth"

Cloud Sandbox Run

Run a one-shot command in a sandbox (creates, executes, destroys)

Prerequisites

  • Authenticated with agentuity auth login
  • Organization context required (--org-id or default org)

Usage

agentuity cloud sandbox run <command...> [options]

Arguments

Argument Type Required Description
<command...> array Yes -

Options

Option Type Required Default Description
--memory string Yes - Memory limit (e.g., "500Mi", "1Gi")
--cpu string Yes - CPU limit in millicores (e.g., "500m", "1000m")
--disk string Yes - Disk limit (e.g., "500Mi", "1Gi")
--network boolean No false Enable outbound network access
--timeout string Yes - Execution timeout (e.g., "5m", "1h")
--env array Yes - Environment variables (KEY=VALUE)
--file array Yes - Files to create in sandbox (sandbox-path:local-path)
--timestamps boolean No false Include timestamps in output (default: true)
--snapshot string Yes - Snapshot ID or tag to restore from
--dependency array Yes - Apt packages to install (can be specified multiple times)

Examples

Run a simple command:

bunx @agentuity/cli cloud sandbox run -- echo "hello world"

Run with resource limits:

bunx @agentuity/cli cloud sandbox run --memory 1Gi --cpu 1000m -- bun run index.ts

Run with network access enabled:

bunx @agentuity/cli cloud sandbox run --network -- curl https://api.example.com

Output

Returns JSON object:

{
  "sandboxId": "string",
  "exitCode": "number",
  "durationMs": "number",
  "output": "string"
}
Field Type Description
sandboxId string Sandbox ID
exitCode number Exit code from the process
durationMs number Duration in milliseconds
output string Combined stdout/stderr output