Pocketenv is an open, interoperable sandbox platform for agents and humans. Run code, test ideas, and prototype safely in isolated environments — without worrying about vendor lock-in.

Note

Still in development

This project is in early development. Expect breaking changes and rapid iteration.

🚚 Installation (CLI)

With Bash:

curl -fsSL https://cli.pocketenv.io | bash

With NPM:

npm install -g @pocketenv/cli

With Homebrew (macOS/Linux):

brew install pocketenv-io/tap/pocketenv

🤔 Why Pocketenv?

Modern sandboxes are fragmented and vendor-specific. Each platform has its own API, its own format, and its own ecosystem.

Pocketenv solves this by providing:

• A unified sandbox interface
• Open, portable sandbox definitions
• Vendor-agnostic execution
• Interoperability via AT Protocol lexicons
• A platform designed for both AI agents and humans

With Pocketenv, sandboxes become portable, shareable, and open.

🚀 Pocketenv is right for you if

Pocketenv might be a great fit if you:

• ✅ Want to spin up sandbox environments quickly without managing infrastructure.
• ✅ Need isolated environments for AI agents, experiments, or automation.
• ✅ Want to run code across multiple runtimes like Cloudflare Sandboxes, Daytona, Deno Sandbox ...
• ✅ Prefer working from a simple CLI while still having remote compute power.
• ✅ Need to manage environment variables, secrets, files, volumes, and SSH keys easily.
• ✅ Are building AI tools, dev agents, or automation systems that require ephemeral environments.
• ✅ Want a portable abstraction layer over different sandbox providers.

✨ Key Features

• Secure Isolated Environments
  Run commands, agents, and code safely inside isolated sandboxes with strong separation.

• Vendor-Agnostic Abstraction
  Run sandboxes transparently on Daytona, Cloudflare Sandbox, Vercel Sandbox, Deno Sandbox — and more coming.
  No provider lock-in.

• Agent-Native Design
  Built for modern AI workflows:

  • OpenClaw
  • Codex CLI
  • Claude Code
  • Gemini CLI
  • Copilot CLI
  • …and your custom agents

• Open Sandbox Definitions via AT Protocol
  Sandboxes defined with open lexicons and stored on AT Protocol PDS. Enables discoverable, shareable, versioned sandboxes and a growing community ecosystem.

💡 Example Use Cases

• Prototype and run OpenClaw agents safely in isolated environments
• Prototype AI agents in complete safety
• Run Codex / Claude / Gemini / OpenClaw code in isolation
• Securely test untrusted or third-party code
• Share reproducible developer environments
• Spin up temporary / ephemeral dev sandboxes
• Provide sandbox infrastructure as a service for your application

📚 Documentation

View the full documentation

✍️ Feedback

This repository is the central place to collect feedback and issues related to Pocketenv.

Please open an issue if you want to leave feedback. Feel free to also join our Discord server

🤝 Contributing

We would love to hear your feedback or suggestions. The best way to reach us is on Discord.

We also welcome pull requests into this repo. See CONTRIBUTING.md for information on setting up this repo locally.