Back to list
agentuity

agentuity-cli-cloud-sandbox-run

by agentuity

This project contains the Agentuity documentation website.

4🍴 1📅 Jan 23, 2026

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.1.24" 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

ArgumentTypeRequiredDescription
<command...>arrayYes-

Options

OptionTypeRequiredDefaultDescription
--runtimestringYes-Runtime name (e.g., "bun:1", "python:3.14")
--runtimeIdstringYes-Runtime ID (e.g., "srt_xxx")
--namestringYes-Sandbox name
--descriptionstringYes-Sandbox description
--memorystringYes-Memory limit (e.g., "500Mi", "1Gi")
--cpustringYes-CPU limit in millicores (e.g., "500m", "1000m")
--diskstringYes-Disk limit (e.g., "500Mi", "1Gi")
--networkbooleanNofalseEnable outbound network access
--timeoutstringYes-Execution timeout (e.g., "5m", "1h")
--envarrayYes-Environment variables (KEY=VALUE)
--filearrayYes-Files to create in sandbox (sandbox-path:local-path)
--timestampsbooleanNofalseInclude timestamps in output (default: true)
--snapshotstringYes-Snapshot ID or tag to restore from
--dependencyarrayYes-Apt packages to install (can be specified multiple times)
--projectIdstringYes-Project ID to associate this sandbox with

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"
}
FieldTypeDescription
sandboxIdstringSandbox ID
exitCodenumberExit code from the process
durationMsnumberDuration in milliseconds
outputstringCombined stdout/stderr output

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon