@flue/cli
2.3.1 · 18 Nov 2026Apache-2.0217.3k / weekRepositoryHomepagenpmAtom feed
0.11.1 is the newest release of 0.7.x.
In short
1 breaking1 new
- Breaking
getVirtualSandbox()now throws with a migration message. The previous API described R2 as if it were mounted directly as the harness filesystem, but@cloudflare/shellWorkspaces are SQLite-indexed filesystems with optional R2 blob spillover; raw bucket keys uploaded outside Workspace were invisible. Migrate bucket-backed agents togetShellSandbox({ workspace, loader })plushydrateFromBucket(workspace, env.BUCKET)beforeinit(). If you used zero-arggetVirtualSandbox(), remove it and omitsandboxfrominit()to use Flue's default in-memory sandbox.
Release note
New Features
Cloudflare shell sandbox. Added
getShellSandbox({ workspace, loader }),getDefaultWorkspace(), andhydrateFromBucket()from@flue/runtime/cloudflare. The new sandbox wires@cloudflare/shellWorkspaces into Flue through a codemodecodetool backed by a Worker Loader binding. Agents usestate.*inside thecodetool instead of bash/read/write/grep/glob. Use@cloudflare/shelldirectly for primitives likeWorkspace,WorkspaceFileSystem, andcreateGit.
Breaking Changes
- Breaking
getVirtualSandbox()now throws with a migration message. The previous API described R2 as if it were mounted directly as the harness filesystem, but@cloudflare/shellWorkspaces are SQLite-indexed filesystems with optional R2 blob spillover; raw bucket keys uploaded outside Workspace were invisible. Migrate bucket-backed agents togetShellSandbox({ workspace, loader })plushydrateFromBucket(workspace, env.BUCKET)beforeinit(). If you used zero-arggetVirtualSandbox(), remove it and omitsandboxfrominit()to use Flue's default in-memory sandbox.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.