# Sandboxes CLI

> Koyeb Sandboxes (CLI)

- Skill: `koyeb/sandboxes-cli` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add koyeb/sandboxes-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/koyeb/sandboxes-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: koyeb (https://skillmd.com/u/koyeb)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/koyeb/sandboxes-cli

---


# 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

1. Create or identify a sandbox.
2. Check health and list running processes.
3. Run commands or start background processes.
4. Expose or unexpose ports as needed.
5. 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