File contents Koyeb Sandboxes (CLI)
When to use
Use this skill to interact with Koyeb sandboxes created via koyeb service create --type=sandbox, including running commands, managing processes, files, and ports.
Prerequisites
Koyeb CLI installed and on PATH
Authenticated session (see references/koyeb-auth.md)
Workflow
Create or identify a sandbox.
Check health and list running processes.
Run commands or start background processes.
Expose or unexpose ports as needed.
Use filesystem commands for data inspection.
Commands
Create sandbox: koyeb sandbox create SANDBOXNAME --app APPNAME [flags]
List sandboxes: koyeb sandbox list SANDBOXNAME/APPNAME[flags]
Check health: koyeb sandbox health SANDBOXNAME/APPNAME [flags]
Run command: koyeb sandbox run SANDBOXNAME/APPNAME -- <command> [args...]
Start process: koyeb sandbox start SANDBOXNAME/APPNAME -- <command> [args...]
List processes: koyeb sandbox ps SANDBOXNAME/APPNAME [flags]
Kill process: koyeb sandbox kill SANDBOXNAME/APPNAME <pid> [flags]
Stream logs: koyeb sandbox logs SANDBOXNAME/APPNAME <pid> [flags]
Filesystem operations: koyeb sandbox fs SANDBOXNAME/APPNAME <subcommand> [flags]
Expose port: koyeb sandbox expose-port SANDBOXNAME/APPNAME <port> [flags]
Unexpose port: koyeb sandbox unexpose-port SANDBOXNAME/APPNAME [flags]
Examples
Create a sandbox: koyeb sandbox create --name my-sandbox
Run a command: koyeb sandbox run SANDBOXNAME/APPNAME -- ls -la
Start a background process: koyeb sandbox start SANDBOXNAME/APPNAME -- python app.py
Expose a port: koyeb sandbox expose-port SANDBOXNAME/APPNAME 8080
References
For detailed flags, see references/koyeb-sandbox-flags.md.
references/koyeb-cli.md
references/koyeb-sandbox-flags.md
references/koyeb-auth.md
references/koyeb-output.md
1 --- 2 name: sandboxes-cli 3 description: Koyeb Sandboxes (CLI) 4 --- 5 6 # Koyeb Sandboxes (CLI) 7 8 ## When to use 9 10 Use this skill to interact with Koyeb sandboxes created via `koyeb service create --type=sandbox`, including running commands, managing processes, files, and ports. 11 12 ## Prerequisites 13 14 - Koyeb CLI installed and on PATH 15 - Authenticated session (see references/koyeb-auth.md) 16 17 ## Workflow 18 19 1. Create or identify a sandbox. 20 2. Check health and list running processes. 21 3. Run commands or start background processes. 22 4. Expose or unexpose ports as needed. 23 5. Use filesystem commands for data inspection. 24 25 ## Commands 26 27 - Create sandbox: `koyeb sandbox create SANDBOXNAME --app APPNAME [flags]` 28 - List sandboxes: `koyeb sandbox list SANDBOXNAME/APPNAME[flags]` 29 - Check health: `koyeb sandbox health SANDBOXNAME/APPNAME [flags]` 30 - Run command: `koyeb sandbox run SANDBOXNAME/APPNAME -- <command> [args...]` 31 - Start process: `koyeb sandbox start SANDBOXNAME/APPNAME -- <command> [args...]` 32 - List processes: `koyeb sandbox ps SANDBOXNAME/APPNAME [flags]` 33 - Kill process: `koyeb sandbox kill SANDBOXNAME/APPNAME <pid> [flags]` 34 - Stream logs: `koyeb sandbox logs SANDBOXNAME/APPNAME <pid> [flags]` 35 - Filesystem operations: `koyeb sandbox fs SANDBOXNAME/APPNAME <subcommand> [flags]` 36 - Expose port: `koyeb sandbox expose-port SANDBOXNAME/APPNAME <port> [flags]` 37 - Unexpose port: `koyeb sandbox unexpose-port SANDBOXNAME/APPNAME [flags]` 38 39 ## Examples 40 41 - Create a sandbox: `koyeb sandbox create --name my-sandbox` 42 - Run a command: `koyeb sandbox run SANDBOXNAME/APPNAME -- ls -la` 43 - Start a background process: `koyeb sandbox start SANDBOXNAME/APPNAME -- python app.py` 44 - Expose a port: `koyeb sandbox expose-port SANDBOXNAME/APPNAME 8080` 45 46 ## References 47 48 For detailed flags, see references/koyeb-sandbox-flags.md. 49 50 - references/koyeb-cli.md 51 - references/koyeb-sandbox-flags.md 52 - references/koyeb-auth.md 53 - references/koyeb-output.md
commit e7d9fe4af9
Frequently asked questions How do I install the Sandboxes CLI skill? Run npx skillmds@latest add koyeb/sandboxes-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Sandboxes CLI skill do? Koyeb Sandboxes (CLI) It is listed under Coding & Dev Tools on SkillMD.
Is Sandboxes CLI safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Sandboxes CLI? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Sandboxes CLI free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Sandboxes CLI? koyeb (@koyeb) published this skill. Their other Agent Skills are listed on their SkillMD profile.
koyeb