Elixir

def deps do
  [
    {:pocketenv_ex, "~> 0.1"}
  ]
end

mix deps.get

import Config

config :pocketenv_ex,
  token:   "your-pocketenv-token",
  api_url: "https://api.pocketenv.io"   # optional

export POCKETENV_TOKEN="your-pocketenv-token"
export POCKETENV_API_URL="https://api.pocketenv.io"   # optional

alias Pocketenv.Sandbox

{:ok, sandbox} =
  Pocketenv.create_sandbox("my-sandbox")
  |> Sandbox.start()
  |> Sandbox.wait_until_running()

{:ok, result} = sandbox |> Sandbox.exec("echo", ["hello"])
IO.puts(result.stdout)   # => "hello"

{:ok, url} = sandbox |> Sandbox.expose(3000)
IO.puts(url)             # => "https://3000-my-sandbox.sbx.pocketenv.io"

sandbox |> Sandbox.stop() |> Sandbox.delete()

# Create
{:ok, sandbox} = Pocketenv.create_sandbox("my-sandbox",
  base:       "openclaw",
  provider:   :cloudflare,
  repo:       "https://github.com/myorg/myapp",
  keep_alive: true
)

# Fetch existing
{:ok, sandbox} = Pocketenv.get_sandbox("my-sandbox")

# List sandboxes
{:ok, {sandboxes, total}} = Pocketenv.list_sandboxes(limit: 20, offset: 0)

# List by actor (DID or handle)
{:ok, {sandboxes, _}} = Pocketenv.list_sandboxes_by_actor("alice.bsky.social")

# Lifecycle
{:ok, sandbox} = sandbox |> Sandbox.start()
{:ok, sandbox} = sandbox |> Sandbox.stop()
{:ok, sandbox} = sandbox |> Sandbox.delete()

# Poll until running
{:ok, sandbox} =
  Pocketenv.create_sandbox("ci-runner")
  |> Sandbox.start()
  |> Sandbox.wait_until_running(timeout_ms: 120_000, interval_ms: 3_000)

{:ok, result} = sandbox |> Sandbox.exec("ls", ["-la", "/"])
IO.puts(result.stdout)
IO.puts(result.stderr)
IO.inspect(result.exit_code)

# Expose a port
{:ok, preview_url} = sandbox |> Sandbox.expose(3000)
{:ok, preview_url} = sandbox |> Sandbox.expose(3000, description: "API server")
IO.puts(preview_url)

# Unexpose
:ok = sandbox |> Sandbox.unexpose(3000)

# List exposed ports
{:ok, ports} = sandbox |> Sandbox.list_ports()

# VS Code
{:ok, vscode_url} = sandbox |> Sandbox.vscode()

# Current user
{:ok, me} = Pocketenv.me()
IO.puts("Logged in as @#{me.handle}")

# Any user by DID or handle
{:ok, profile} = Pocketenv.get_profile("alice.bsky.social")