https://github.com/pocketenv-io/pocketenv
the universal sandbox runtime for agents and humans.
https://github.com/pocketenv-io/pocketenv
agent atproto claude-code cloudflare daytona dev-workspace developer-tools development-environment docker firecracker microvm nix openclaw sandbox typescript wasmer
Last synced: 16 days ago
JSON representation
the universal sandbox runtime for agents and humans.
- Host: GitHub
- URL: https://github.com/pocketenv-io/pocketenv
- Owner: pocketenv-io
- License: mpl-2.0
- Created: 2024-02-02T18:47:44.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-07T08:57:13.000Z (20 days ago)
- Last Synced: 2026-04-07T10:27:42.488Z (20 days ago)
- Topics: agent, atproto, claude-code, cloudflare, daytona, dev-workspace, developer-tools, development-environment, docker, firecracker, microvm, nix, openclaw, sandbox, typescript, wasmer
- Language: TypeScript
- Homepage: https://pocketenv.io
- Size: 7.45 MB
- Stars: 60
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://discord.gg/9ada4pFUFS)
[](https://github.com/pocketenv-io/pocketenv/actions/workflows/deploy.yml)
**Pocketenv** is an open sandbox platform — for agents, for tinkerers, for anyone tired of being locked into one provider's ecosystem.
Spin up isolated environments, run code, test weird ideas. No drama.
> [!NOTE]
> **heads up — still in early dev**
>
> Things will break. APIs will change. We move fast. You've been warned (and we appreciate your patience).
---
## Install
**Bash:**
```sh
curl -fsSL https://cli.pocketenv.io | bash
```
**npm:**
```sh
npm install -g @pocketenv/cli
```
**Homebrew (macOS/Linux):**
```sh
brew install pocketenv-io/tap/pocketenv
```
**Nix (Flakes):**
```sh
nix profile install github:pocketenv-io/pocketenv
```
**Arch Linux:**
```sh
yay -Syu pocketenv
```
---
## Why does this exist?
Honestly? Because every sandbox tool out there wants you to commit to their platform. Their API, their format, their rules. Switch providers and you're rewriting everything.
Pocketenv is the escape hatch. One interface, multiple backends — Cloudflare, Daytona, Deno, Vercel, and more. Write once, run anywhere (for real this time).
It also uses [AT Protocol](https://atproto.com) lexicons under the hood, which means sandbox definitions are open, portable, and not owned by anyone.
---
## Is it for you?
Probably yes if any of these sound familiar:
- You keep spinning up environments and tearing them down manually
- You're building AI agents that need a safe place to run code
- You want to test untrusted code without torching your machine
- You're sick of rewriting glue code every time you switch sandbox providers
- You just want a clean CLI and a reliable environment, no infra headaches
---
## What it can do
**Run sandboxes on whatever backend you want**
Daytona, Cloudflare Sandbox, Vercel Sandbox, Deno Sandbox — swap between them without changing your workflow.
**Works with the AI tools you're already using**
Claude Code, Codex CLI, Gemini CLI, Copilot, OpenClaw, your own agents — they all just work.
**Handles the boring stuff**
Env vars, secrets, files, volumes, SSH keys — managed cleanly so you don't have to think about it.
**Open sandbox definitions**
Sandboxes are defined using open lexicons and stored on AT Protocol PDS. That means they're versioned, shareable, and actually portable.
---
## Things people use it for
- Giving AI agents a safe place to run code (without the anxiety)
- Sharing reproducible dev environments with teammates
- Testing third-party or untrusted code in isolation
- Quick throwaway sandboxes for experiments
- Building internal tools that need ephemeral compute
---
## SDKs
- [JavaScript/TypeScript](https://github.com/pocketenv-io/pocketenv-js)
- [Gleam](https://github.com/pocketenv-io/pocketenv-gleam)
- [Clojure](https://github.com/pocketenv-io/pocketenv-clojure)
- [Elixir](https://github.com/pocketenv-io/pocketenv-elixir)
---
## Docs
Full docs over at [docs.pocketenv.io](https://docs.pocketenv.io)
---
## Feedback & bugs
Open an [issue](https://github.com/pocketenv-io/pocketenv/issues/new) or come yell at us (nicely) on [Discord](https://discord.gg/9ada4pFUFS). We read everything.
---
## Contributing
PRs are welcome. Come say hi on [Discord](https://discord.gg/9ada4pFUFS) first if you're planning something big — saves everyone time.
Setup instructions are in [CONTRIBUTING.md](CONTRIBUTING.md).