quickstart.mdx

title	Quickstart
description	Install the CLI, log in, and run your first sandbox in under 5 minutes.

Install the CLI

```bash npm install -g @pocketenv/cli ``` ```bash brew install pocketenv-io/tap/pocketenv ``` ```bash curl -fsSL https://cli.pocketenv.io | bash ``` ```bash bun install -g @pocketenv/cli ``` ```bash pnpm add -g @pocketenv/cli ``` ```bash nix profile install github:pocketenv-io/pocketenv ```

Verify the installation:

pocketenv --version

Log in

Pocketenv uses your AT Protocol handle (e.g. a Bluesky account) for authentication.

pocketenv login alice.bsky.social

This opens a browser window to complete the OAuth flow. Once done, your session token is saved to ~/.pocketenv/token.json.

For CI/CD environments, skip the browser flow by setting the `POCKETENV_TOKEN` environment variable instead.

Create a sandbox

pocketenv create

By default this uses the cloudflare provider and the openclaw base image — a minimal Linux environment with openclaw and common dev tools pre-installed.

Specify a different provider or base:

pocketenv create my-sandbox --provider daytona --base openclaw

Run a command

pocketenv exec my-first-sandbox "echo hello from the sandbox"
# hello from the sandbox

Open an interactive shell

pocketenv console my-first-sandbox

This drops you into a live SSH session inside the sandbox. Type exit to return to your local terminal.

Start, stop, and delete

pocketenv stop my-first-sandbox    # Stop the sandbox
pocketenv start my-first-sandbox   # Resume it later
pocketenv rm my-first-sandbox      # Delete permanently

Next steps

Configure Daytona, Vercel, E2B, Modal, and more. Make your sandbox services accessible from the internet. Store credentials and configuration securely. Use Pocketenv programmatically from TypeScript/JavaScript.