Skip to main content

​
Install the CLI

npm install -g @pocketenv/cli
Verify the installation: 
pocketenv --version
cli.png

​
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

Providers

Configure Daytona, Vercel, E2B, Modal, and more.

Expose ports

Make your sandbox services accessible from the internet.

Secrets & env vars

Store credentials and configuration securely.

SDK

Use Pocketenv programmatically from TypeScript/JavaScript.