Open-source CLI for Vercel Eve

Deploy your Eve agent
to your own Cloudflare.

NoRewriteneeded

Take the Eve agent you already built and run it on your own Cloudflare account with one command. It updates in place, sleeps when idle, and wakes for messages and schedules.

npx @moinulmoin/eden deploy

Recorded from a real deploy

One command. Live on your Cloudflare.

eve 0.81.0 · lines trimmed
› eden deploy --env-file ~/.config/my-eve-agent.env
eden deploy — my-eve-agent-9e510242 (preview)
... validating environment file
... packaging project — snapshot, frozen install, eve build
... checking Cloudflare access and exact target
... building linux/amd64 runtime image, booting eve, checking health
... pushing container image to the Cloudflare registry
... registering runtime variables
... publishing Worker and Container application
... verifying health at https://my-eve-agent-9e510242.moinulislammoin2019.workers.dev

✓ deployed my-eve-agent-9e510242 (preview) · eve 0.81.0
  https://my-eve-agent-9e510242.moinulislammoin2019.workers.dev
  done in 215s
› 
215shealthy · promoted
01 · How it runs

Your real Eve server,
in a Cloudflare Container.

The same Eve server you run locally, built on your machine and served from your account. Nothing gets translated.

  1. 01 · your machine

    Eve project

    Your agent, exactly as you wrote it.

  2. 02 · local docker

    Eden builder

    Eve's own build, packed into a production image.

  3. Your Cloudflare account
    1. 03 · edge

      Worker

      Your public workers.dev URL, at the edge.

    2. 04 · 4 GiB

      Container

      Your Eve server. Sleeps when idle, wakes on the next request.

GET /eve/v1/health → 200

Traffic switches only after the new version answers healthy.

02 · After you deploy

Keep shipping.
It keeps running.

  • Update in place

    Run eden deploy again. Same URL, new code, every conversation's files carried over.

  • Sleeps when idle

    After an hour without traffic it sleeps and saves its disk. The next message wakes it in seconds.

  • Schedules on time

    Cron schedules wake your agent on time, even while it sleeps.

03 · What stays yours

Your stack, untouched.

The same models, databases, channels and auth you already use. Eden hosts the app and leaves the rest as you set it up.

Your code, unchanged
  • These stay in Eve
  • Model providers and credentialsstays in Eve
  • Databases, queues and external APIsstays in Eve
  • Channels, schedules and authstays in Eve
  • Workflow World and skillsstays in Eve
  • Values from --env-filenever in args, image layers or logs
04 · The CLI

Three commands to ship.

every command takes --json
  • eden preflight

    Checks your project and Cloudflare account without changing anything. Optional.

  • eden deploy

    Ships your agent and checks it's healthy. Run it again to update in place.

  • eden destroy --name

    Removes that deployment and everything it created. Nothing else.

05 · Before you deploy

What you need, and what to expect.

You'll need

6 things
  • macOS or Linux with Node 24.17 or newer
  • A Cloudflare account on Workers Paid, which Containers require
  • Wrangler signed innpx wrangler@4.147.0 login
  • Docker or OrbStack that builds linux/amd64
  • An Eve 0.91 or later project with its root lockfile: npm, or pnpm with an exact pinpackage-lock.json
  • just-bash as a production dependencynpm install just-bash
  • JustBash selected in agent/sandbox.tsJustBashSandbox.environment()

Good to know

in 0.12.0
  • Updates reset workflow state by defaultFiles survive sleep and updates; the Cloudflare World keeps sessions across Eve upgrades
  • Only 5-field cron schedules fire while it sleepsA Cloudflare Cron wakes the Container; others run while it's awake
  • The sandbox is just-bash, not a Linux VMFiles, grep, jq and curl work; python, git and npm don't
  • One Container instance (1/2 vCPU, 4 GiB)Plus older Eve versions until their sessions end; no horizontal scaling or custom domains yet
  • npm and pnpm projectsDependency install scripts don't run on npm; Bun lockfiles and native Windows aren't supported yet
Open source · Apache-2.0

Your Eve agent.
Your Cloudflare.

npm install --global @moinulmoin/eden