From dbc0f8e07f6918eadb45e77cece87d20b3833149 Mon Sep 17 00:00:00 2001
From: Ryuz
Date: Thu, 19 Nov 2026 08:01:20 +0100
Subject: [PATCH] Migrate docs, console copy, hostile fixtures to Cello
- celld.md -> cello.md; retarget /guides/celld, add /agents/platform/celld redirect
- docs prose, console islands, hostile fixtures/scripts/test: celld -> cello
---
AGENTS.md | 6 +++---
crates/outer/tests/hostile.rs | 16 ++++++++--------
e2e/hostile/manifest.json | 2 +-
e2e/hostile/package.json | 2 +-
e2e/hostile/r2-probe.mjs | 6 +++---
e2e/hostile/worker.js | 6 +++---
scripts/hostile-probe-vps.sh | 2 +-
scripts/hostile-suite.sh | 2 +-
web/blume.config.ts | 4 ++--
web/docs/STYLE.md | 2 +-
web/docs/agents/backend/database.md | 4 ++--
web/docs/agents/backend/files.md | 6 +++---
web/docs/agents/backend/kv.md | 2 +-
web/docs/agents/backend/sandboxes.md | 2 +-
web/docs/agents/deploy/pipeline.md | 4 ++--
web/docs/agents/frontend/website.md | 2 +-
web/docs/agents/platform/{celld.md => cello.md} | 4 ++--
web/docs/agents/platform/meta.ts | 2 +-
web/docs/agents/testing/previews.md | 2 +-
web/docs/frontend/install-on-phones.mdx | 2 +-
web/docs/get-started/console-tour.mdx | 2 +-
web/docs/reference/tools.md | 4 ++--
web/pages/console/_islands/actions/data-do.ts | 4 ++--
web/pages/console/_islands/actions/data-r2.ts | 2 +-
web/pages/console/_islands/data/do/view.tsx | 6 +++---
25 files changed, 48 insertions(+), 48 deletions(-)
rename web/docs/agents/platform/{celld.md => cello.md} (87%)
diff --git a/AGENTS.md b/AGENTS.md
index 4c0f04d1..4f52ebff 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,6 +1,6 @@
# Outer: agent working agreement
-Outer is a personal software forge for AI agents. An agent talks MCP to Outer, Outer builds the user's Ilha + Void app and runs it on [celld](https://celld.dev), and serves it at `https://.outer.now`.
+Outer is a personal software forge for AI agents. An agent talks MCP to Outer, Outer builds the user's Ilha + Void app and runs it on [Cello](https://cello.ryuz.eu), and serves it at `https://.outer.now`.
- **Design record:** the maintainer's spec at `~/Developer/vault/outer/spec.md` (not in this repo). Read it before changing behavior, and say so when a change departs from it.
- **Status:** live at `outer.now` (M0 done); milestone M1 (owner alpha) in progress.
@@ -45,7 +45,7 @@ is `crates/outer/tests/hostile.rs`, in two layers:
and the harness refuses to pass unless the installed `inet outer` table
covers the probe uid.
-The `worker.js` `/probes` check needs a live celld fleet with a deployed app
+The `worker.js` `/probes` check needs a live Cello fleet with a deployed app
and stays a manual VPS step (see the script header). A PR that changes escape
relevant behavior adds a fixture probe first, then the containment.
@@ -59,7 +59,7 @@ relevant behavior adds a fixture probe first, then the containment.
| `crates/outer/src/http/` | Axum router: operator probes on the platform host, app proxy fallback for app hosts |
| `crates/outer/src/store/` | `Store` (R2 over S3, or in-memory) and the SQLite snapshot to the bucket |
| `crates/outer/src/git/` | Each app's repo: a bucket WAL (tip bundle + `MANIFEST.json`) and worktree-free commits |
-| `crates/outer/src/fleet/` | Sandboxed processes, cgroup v2 leaves, nft egress rules, the celld supervisor |
+| `crates/outer/src/fleet/` | Sandboxed processes, cgroup v2 leaves, nft egress rules, the Cello supervisor |
| `e2e/hostile/`, `crates/outer/tests/hostile.rs` | Hostile suite (§12.7): fixtures, manifest, two-layer harness |
| `scripts/hostile-suite.sh` | Integrator entry for the privileged hostile layer (VPS) |
## Rules
diff --git a/crates/outer/tests/hostile.rs b/crates/outer/tests/hostile.rs
index 0c035e3f..65bff8ac 100644
--- a/crates/outer/tests/hostile.rs
+++ b/crates/outer/tests/hostile.rs
@@ -15,7 +15,7 @@
//! cgroupfs delegation, the nft table, a JS runtime, scoped R2 creds) is
//! absent, so a dev machine never passes vacuously.
//!
-//! The worker fixture (`e2e/hostile/worker.js`) needs a live celld fleet
+//! The worker fixture (`e2e/hostile/worker.js`) needs a live cello fleet
//! with a deployed app, which no test here can conjure without a bucket; it
//! runs as a documented manual step in `scripts/hostile-suite.sh`.
@@ -225,10 +225,10 @@ fn hostile_fleet_grants_cannot_publish_a_deployment() {
let [(data_permission, data), (deploy_permission, deploy)] = grants;
assert_eq!(data_permission, Permission::ReadWrite);
assert_eq!(deploy_permission, Permission::ReadOnly);
- // The exact state namespaces, a cross-repo contract with celld: any
+ // The exact state namespaces, a cross-repo contract with cello: any
// runtime write outside these is a failed write, and any list wider
// than this (in particular anything covering `deploy/`) is a publish
- // hole. `node-cells/` and the non-terminated `wake-` are celld's dead
+ // hole. `node-cells/` and the non-terminated `wake-` are cello's dead
// node GC and legacy wake guard.
assert_eq!(
data,
@@ -290,7 +290,7 @@ fn hostile_platform_env_never_reaches_apps() {
"AWS_SECRET_ACCESS_KEY",
"AWS_SESSION_TOKEN",
"S3_ENDPOINT",
- "CELLD_WATCH",
+ "CELLO_WATCH",
"OUTER_SECRET",
"OUTER_R2_BUCKET",
"CLOUDFLARE_API_TOKEN",
@@ -316,7 +316,7 @@ fn hostile_platform_env_never_reaches_apps() {
}
/// The fleet command binds loopback only and drops reserved names from app
-/// env: a worker that fetches the celld internal listener or another fleet's
+/// env: a worker that fetches the cello internal listener or another fleet's
/// port from its own environment finds nothing to aim at, and the platform
/// secrets the supervisor holds never enter the fleet's environment.
#[test]
@@ -346,7 +346,7 @@ fn hostile_fleet_command_is_loopback_only_and_scoped() {
],
};
let opts = outer::fleet::supervisor::FleetOpts {
- celld_bin: "celld".to_string(),
+ cello_bin: "cello".to_string(),
state_dir: PathBuf::from("/data/fleets/hostile"),
shutdown_total_ms: 5000,
idle_evict_secs: 60,
@@ -354,7 +354,7 @@ fn hostile_fleet_command_is_loopback_only_and_scoped() {
asset_cache_mb: 256,
};
let (program, args, env) = outer::fleet::supervisor::fleet_command(&spec, &opts);
- assert_eq!(program, "celld");
+ assert_eq!(program, "cello");
for flag in ["--listen", "--internal-listen"] {
let at = args.iter().position(|arg| arg == flag).expect(flag);
let addr = &args[at + 1];
@@ -816,7 +816,7 @@ async fn hostile_build_probes_are_contained() {
/// round-trips inside one and must be refused (403/401, never 404 or a
/// transport error) on a sibling prefix, the bucket root, and the deploy
/// pointer (`deploy/current.json`), because the node reads deployments with
-/// its separate read-only `CELLD_DEPLOY_AWS_*` grant. The probe then uses
+/// its separate read-only `CELLO_DEPLOY_AWS_*` grant. The probe then uses
/// that deploy grant (`HOSTILE_S3_DEPLOY_*`) to LIST and GET under
/// `deploy/` (must succeed) and to PUT there (must be refused). Needs
/// `HOSTILE_S3_*` env with both grants, minted by the integrator on the VPS
diff --git a/e2e/hostile/manifest.json b/e2e/hostile/manifest.json
index 2ccf6afd..925d9018 100644
--- a/e2e/hostile/manifest.json
+++ b/e2e/hostile/manifest.json
@@ -16,7 +16,7 @@
{ "id": "fetch:loopback-target", "phase": "build", "category": "blocked-egress", "must": "fail", "desc": "Build cannot reach a live loopback listener (fail-closed: the harness proves it serves)" },
{ "id": "fetch:internet", "phase": "build", "category": "blocked-egress", "must": "succeed", "desc": "Positive control: ordinary internet egress still works" },
{ "id": "fetch:neighbour-fleet", "phase": "worker", "category": "fleet-ports", "must": "fail", "desc": "Worker cannot fetch another fleet's public port" },
- { "id": "fetch:platform-internal", "phase": "worker", "category": "fleet-ports", "must": "fail", "desc": "Worker cannot fetch outer's loopback / celld internal ports" },
+ { "id": "fetch:platform-internal", "phase": "worker", "category": "fleet-ports", "must": "fail", "desc": "Worker cannot fetch outer's loopback / cello internal ports" },
{ "id": "fetch:metadata", "phase": "worker", "category": "blocked-egress", "must": "fail", "desc": "Worker cannot reach the cloud metadata IP" },
{ "id": "fetch:smtp-worker", "phase": "worker", "category": "blocked-egress", "must": "fail", "desc": "Worker cannot open SMTP ports" },
{ "id": "env:worker-secrets", "phase": "worker", "category": "host-secrets", "must": "fail", "desc": "No platform secret names in the worker env" },
diff --git a/e2e/hostile/package.json b/e2e/hostile/package.json
index a8d5b91a..9c04d1cb 100644
--- a/e2e/hostile/package.json
+++ b/e2e/hostile/package.json
@@ -2,7 +2,7 @@
"name": "outer-hostile-fixture",
"private": true,
"version": "1.0.0",
- "description": "Hostile tenant fixture for the §12.7 hostile suite: a celld worker plus build/release probes that try to escape. See manifest.json and scripts/hostile-suite.sh.",
+ "description": "Hostile tenant fixture for the §12.7 hostile suite: a cello worker plus build/release probes that try to escape. See manifest.json and scripts/hostile-suite.sh.",
"scripts": {
"build": "node ./build-probe.mjs",
"release": "node ./r2-probe.mjs"
diff --git a/e2e/hostile/r2-probe.mjs b/e2e/hostile/r2-probe.mjs
index db758024..aa9bec6a 100644
--- a/e2e/hostile/r2-probe.mjs
+++ b/e2e/hostile/r2-probe.mjs
@@ -12,7 +12,7 @@
// - the *state* credential (HOSTILE_S3_KEY/SECRET): read-write over the
// state prefixes and NOT over `deploy/` or `deploy-blobs/`;
// - the *deploy* credential (HOSTILE_S3_DEPLOY_KEY/SECRET): read-only over
-// `deploy/` and `deploy-blobs/` (the node's CELLD_DEPLOY_AWS_* grant).
+// `deploy/` and `deploy-blobs/` (the node's CELLO_DEPLOY_AWS_* grant).
// So the state positive control round-trips inside a state prefix and a
// write to the deployment pointer must be refused, while the deploy grant
// reads `deploy/` and a write with it is refused too.
@@ -40,7 +40,7 @@ const token = process.env.HOSTILE_S3_TOKEN ?? "";
const ownPrefix = need("HOSTILE_S3_PREFIX").replace(/^\//, "");
const siblingPrefix = (process.env.HOSTILE_S3_SIBLING ?? "fleets/hostile-neighbour/").replace(/^\//, "");
const dataPrefix = (process.env.HOSTILE_S3_DATA_PREFIX ?? `${ownPrefix}cells/`).replace(/^\//, "");
-// The node's read-only deployment grant (`CELLD_DEPLOY_AWS_*`): it must
+// The node's read-only deployment grant (`CELLO_DEPLOY_AWS_*`): it must
// read `deploy/` and `deploy-blobs/` but can never publish. The object the
// GET probe reads is uploaded by the integrator with the bucket root keys.
const deployAccess = need("HOSTILE_S3_DEPLOY_KEY");
@@ -113,7 +113,7 @@ try {
}
// The deployment artifacts are read-only for a fleet: the node's
-// `CELLD_DEPLOY_AWS_*` grant must list and get `deploy/` and can never
+// `CELLO_DEPLOY_AWS_*` grant must list and get `deploy/` and can never
// publish. The positive read proves the grant is the deploy one, not a
// state key; the refused write is the boundary under test.
try {
diff --git a/e2e/hostile/worker.js b/e2e/hostile/worker.js
index 50642aa9..5e7109a4 100644
--- a/e2e/hostile/worker.js
+++ b/e2e/hostile/worker.js
@@ -1,9 +1,9 @@
-// Hostile app worker (celld): serves its build/r2 probe results as JSON and
+// Hostile app worker (cello): serves its build/r2 probe results as JSON and
// runs the Worker-side network probes live. Every probe must fail except
// internet egress. Borrowed from Noite's apps/noite/test/hostile/index.js:
// Outer drops the Caddy/runner/control-port targets and aims at Outer's own
// loopback surface instead (neighbour fleet ports, outer's proxy port, the
-// celld internal listener). Query: /probes?neighbour=&platform=.
+// cello internal listener). Query: /probes?neighbour=&platform=.
import buildProbes from "./dist/probe.json";
import releaseProbes from "./dist/release-probe.json";
@@ -36,7 +36,7 @@ export default {
);
worker[n1] = v1;
- // Outer's own loopback surface (proxy port, celld internal listener):
+ // Outer's own loopback surface (proxy port, cello internal listener):
// unreachable from a tenant uid under the nft policy.
const [n2, v2] = await attempt("fetch:platform-internal", () =>
timedFetch(`http://127.0.0.1:${platform}/`)
diff --git a/scripts/hostile-probe-vps.sh b/scripts/hostile-probe-vps.sh
index 279217e2..1470db17 100755
--- a/scripts/hostile-probe-vps.sh
+++ b/scripts/hostile-probe-vps.sh
@@ -225,7 +225,7 @@ for planted in "OUTER_SECRET planted" "STRIPE_SECRET_KEY planted" "AWS_SECRET_AC
set -- $planted
case "$1" in
PORT|HOST|NODE_OPTIONS) continue ;;
- AWS_*|S3_*|CELLD_*|OUTER_*|CLOUDFLARE_*|R2_*|STRIPE_*|RESEND_*|JEV_*|LD_*|BUN_*)
+ AWS_*|S3_*|CELLD_*|CELLO_*|OUTER_*|CLOUDFLARE_*|R2_*|STRIPE_*|RESEND_*|JEV_*|LD_*|BUN_*)
[ "$1" = "BUN_INSTALL_CACHE_DIR" ] || continue ;;
esac
putenv "$1" "$2"
diff --git a/scripts/hostile-suite.sh b/scripts/hostile-suite.sh
index 07592417..514ac2a6 100755
--- a/scripts/hostile-suite.sh
+++ b/scripts/hostile-suite.sh
@@ -50,7 +50,7 @@
# HOSTILE_S3_DEPLOY_KEY HOSTILE_S3_DEPLOY_SECRET
# HOSTILE_S3_DEPLOY_TOKEN HOSTILE_S3_DEPLOY_PREFIX (=deploy/)
# HOSTILE_S3_DEPLOY_OBJECT (default deploy/hostile-probe.json)
-# - Worker layer (manual, needs celld + a bucket): deploy the fixture as
+# - Worker layer (manual, needs cello + a bucket): deploy the fixture as
# two apps (`hostile`, `hostile-neighbour`), then
# curl 'https://hostile./probes?neighbour=&platform='
# and confirm every worker probe is contained except `fetch:internet`.
diff --git a/web/blume.config.ts b/web/blume.config.ts
index 5458415f..f6cb04cc 100644
--- a/web/blume.config.ts
+++ b/web/blume.config.ts
@@ -62,8 +62,8 @@ export default defineConfig({
{ from: "/guides/ilha", to: "/agents/frontend/ilha", status: 301 },
{ from: "/guides/void", to: "/agents/frontend/void", status: 301 },
{ from: "/guides/website", to: "/agents/frontend/website", status: 301 },
- { from: "/guides/celld", to: "/agents/platform/celld", status: 301 },
- { from: "/guides/moderation", to: "/agents/security/moderation", status: 301 },
+ { from: "/guides/celld", to: "/agents/platform/cello", status: 301 },
+ { from: "/agents/platform/celld", to: "/agents/platform/cello", status: 301 },
{ from: "/guides/limits", to: "/agents/platform/limits", status: 301 },
{ from: "/guides/storage", to: "/agents/backend/files", status: 301 },
{ from: "/guides/export", to: "/agents/deploy/export", status: 301 },
diff --git a/web/docs/STYLE.md b/web/docs/STYLE.md
index 15aed957..83f5c279 100644
--- a/web/docs/STYLE.md
+++ b/web/docs/STYLE.md
@@ -41,7 +41,7 @@ One term per concept. Left column wins everywhere.
| plan (Free / Pro) | tier, subscription (as plan name) | Capitalized plan names. |
| quota | limit (for counted resources) | Code changes, apps, collaborators. `limits` only for the Deploy page title and hard technical caps. |
| preview deploy | staging, branch deploy | One per app, Pro, at `--preview.outer.now`. |
-| fleet | server, container, instance | The celld worker pool an app runs on. |
+| fleet | server, container, instance | The Cello worker pool an app runs on. |
| binding | integration, env (for config) | `d1_databases`, `kv_namespaces`, declared in `void.config.ts`. |
| secret | env var, token (for stored keys) | Set outside code, read as `env.MY_KEY`. |
| agent | bot, assistant (for the builder) | The AI building the app over MCP. |
diff --git a/web/docs/agents/backend/database.md b/web/docs/agents/backend/database.md
index cf834b65..74bdb1c2 100644
--- a/web/docs/agents/backend/database.md
+++ b/web/docs/agents/backend/database.md
@@ -13,7 +13,7 @@ The template ships with D1 on by default. Copy `pages/index.server.ts`: a loader
d1_databases: [{ binding: "DB", database_name: "app-db" }],
```
-One D1 database and one R2 bucket per app: a second `d1_databases` entry fails the deploy at validation ("Outer apps can have one D1 database and one R2 bucket for now; merge the extra ones"). The built `dist/wrangler.json` carries the binding to celld, which creates the database on first use. Celld keys the database by name, so a typo opens a silent empty database. Double-check the name.
+One D1 database and one R2 bucket per app: a second `d1_databases` entry fails the deploy at validation ("Outer apps can have one D1 database and one R2 bucket for now; merge the extra ones"). The built `dist/wrangler.json` carries the binding to Cello, which creates the database on first use. Cello keys the database by name, so a typo opens a silent empty database. Double-check the name.
## Ship schema as migrations
@@ -29,7 +29,7 @@ Migration order depends on deploy state:
| App with a live version | Migrations run before the upload; the old code keeps serving, and a migrate failure uploads nothing |
| First deploy | Upload first, then migrate; the proxy returns 503 (building page) until the first deploy succeeds, so no race is possible |
-Files apply in numeric-prefix order under the app's scoped storage credentials. Already-applied files are skipped, never re-applied. A file edited after it was applied fails the deploy. Write a new migration instead. A failing migration fails the deploy and names the file; the previous version keeps serving (first deploys stay not-live, "Your app isn't live yet"), with celld's error in the log tail. The step runs only when the built config declares `d1_databases` and the repo holds migration files; no files means the step is skipped.
+Files apply in numeric-prefix order under the app's scoped storage credentials. Already-applied files are skipped, never re-applied. A file edited after it was applied fails the deploy. Write a new migration instead. A failing migration fails the deploy and names the file; the previous version keeps serving (first deploys stay not-live, "Your app isn't live yet"), with Cello's error in the log tail. The step runs only when the built config declares `d1_databases` and the repo holds migration files; no files means the step is skipped.
Expand first, contract later: the migration runs while the old code still serves, so prefer additive changes (new tables, nullable columns). Dropping a column the live code still reads serves errors until the new version takes over.
diff --git a/web/docs/agents/backend/files.md b/web/docs/agents/backend/files.md
index be86f37f..7d7bf668 100644
--- a/web/docs/agents/backend/files.md
+++ b/web/docs/agents/backend/files.md
@@ -3,7 +3,7 @@ title: Store uploads in R2
description: R2 uploads behind your own checks, the Console R2 browser, and the read-only Durable Object handler.
---
-Extra state arrives as bindings in `void.config.ts`, validated from the built `dist/wrangler.json` at deploy time. Only keys celld accepts pass. One D1 database and one R2 bucket per app: a second `r2_buckets` entry fails the deploy at validation. The person-facing guide is [Store uploaded files](/backend/files-storage).
+Extra state arrives as bindings in `void.config.ts`, validated from the built `dist/wrangler.json` at deploy time. Only keys Cello accepts pass. One D1 database and one R2 bucket per app: a second `r2_buckets` entry fails the deploy at validation. The person-facing guide is [Store uploaded files](/backend/files-storage).
## Gate uploads yourself
@@ -11,11 +11,11 @@ Declare file storage with `r2_buckets`. Uploaded images and video are not profan
## Browse files in Console
-Console → your app → **Data → R2** opens the app's single `r2_buckets` binding directly. You can browse folders, preview text (up to 256 KiB) and images inline, download (up to 64 MiB), upload (up to 64 MiB), create folders, and delete with confirmation. Reads use the same scoped credentials as your app; writes go through celld and are recorded in the agent action log. The binding list comes from the deployed manifest in your bucket, not the local build directory.
+Console → your app → **Data → R2** opens the app's single `r2_buckets` binding directly. You can browse folders, preview text (up to 256 KiB) and images inline, download (up to 64 MiB), upload (up to 64 MiB), create folders, and delete with confirmation. Reads use the same scoped credentials as your app; writes go through Cello and are recorded in the agent action log. The binding list comes from the deployed manifest in your bucket, not the local build directory.
## Expose Durable Object state read-only
-Console → your app → **Data → Durable Objects** lists every `durable_objects` binding's instances (read-only; celld exposes no generic storage API for an instance). Selecting an instance shows what the app's own `?read=1` handler returns for it. Implement that read-only branch without side effects:
+Console → your app → **Data → Durable Objects** lists every `durable_objects` binding's instances (read-only; Cello exposes no generic storage API for an instance). Selecting an instance shows what the app's own `?read=1` handler returns for it. Implement that read-only branch without side effects:
```js
if (new URL(request.url).searchParams.has("read")) {
diff --git a/web/docs/agents/backend/kv.md b/web/docs/agents/backend/kv.md
index 947ffd4a..cbc906c3 100644
--- a/web/docs/agents/backend/kv.md
+++ b/web/docs/agents/backend/kv.md
@@ -15,7 +15,7 @@ cloudflare: {
},
```
-`kv_namespaces` is an accepted deploy key, so the namespace deploys on every account. Binding keys are validated at deploy time. See [Store uploaded files](/backend/files-storage). Celld creates the namespace on first use; a typo opens a silent empty namespace, so double-check the id.
+`kv_namespaces` is an accepted deploy key, so the namespace deploys on every account. Binding keys are validated at deploy time. See [Store uploaded files](/backend/files-storage). Cello creates the namespace on first use; a typo opens a silent empty namespace, so double-check the id.
## Use it
diff --git a/web/docs/agents/backend/sandboxes.md b/web/docs/agents/backend/sandboxes.md
index 3048acee..6c22f8af 100644
--- a/web/docs/agents/backend/sandboxes.md
+++ b/web/docs/agents/backend/sandboxes.md
@@ -7,7 +7,7 @@ description: Code-execution sandboxes are not available on Outer — do not ship
## Know why it cannot run
-Void sandboxes (`getSandbox(id)`, `sandbox.run/files/fetch`) are isolated Linux containers fronted by a Durable Object. They need Cloudflare Containers: a container runtime on every machine that can start the app's image. Outer runs each app as a celld worker fleet: plain processes under cgroup and network isolation, no Docker/Podman daemon on the app host. A sandbox has nowhere to start. The `containers` wrangler key passes Outer's deploy validation, so the failure would come at runtime, not at deploy. Do not ship sandbox code expecting the deploy gate to catch it.
+Void sandboxes (`getSandbox(id)`, `sandbox.run/files/fetch`) are isolated Linux containers fronted by a Durable Object. They need Cloudflare Containers: a container runtime on every machine that can start the app's image. Outer runs each app as a Cello worker fleet: plain processes under cgroup and network isolation, no Docker/Podman daemon on the app host. A sandbox has nowhere to start. The `containers` wrangler key passes Outer's deploy validation, so the failure would come at runtime, not at deploy. Do not ship sandbox code expecting the deploy gate to catch it.
## Do this instead
diff --git a/web/docs/agents/deploy/pipeline.md b/web/docs/agents/deploy/pipeline.md
index eeb329b9..73b9df68 100644
--- a/web/docs/agents/deploy/pipeline.md
+++ b/web/docs/agents/deploy/pipeline.md
@@ -1,6 +1,6 @@
---
title: Follow the deploy pipeline
-description: Move commits through queue, build, gate, migrations, and celld deploy.
+description: Move commits through queue, build, gate, migrations, and Cello deploy.
---
## Move through each pipeline step
@@ -11,7 +11,7 @@ description: Move commits through queue, build, gate, migrations, and celld depl
4. Run `bun run build`; wrangler validation rejects unknown config keys by name (full list: [Accepted config keys](/agents/platform/config-keys)).
5. Pass the moderation gate; nothing uploads before it passes.
6. Apply D1 migrations scoped by key: before upload when a live version exists, otherwise upload, wake, then migrate.
-7. Deploy with celld, then poll fleet health; a failed step or health check keeps the previous version serving.
+7. Deploy with Cello, then poll fleet health; a failed step or health check keeps the previous version serving.
8. Expect wiped worktrees: sleep, failed builds, and deletes remove everything except `node_modules`.
## Watch a deploy to its terminal state
diff --git a/web/docs/agents/frontend/website.md b/web/docs/agents/frontend/website.md
index e12b577b..b17701f0 100644
--- a/web/docs/agents/frontend/website.md
+++ b/web/docs/agents/frontend/website.md
@@ -42,7 +42,7 @@ export const POST: APIRoute = async () => {
4. Declare new bindings on `Cloudflare.Env` in `src/env.d.ts`.
5. Keep server routes few and small: at most one or two against D1.
-## Ship config and schema the celld way
+## Ship config and schema the Cello way
1. Edit `astro.config.mjs` (`celld-config` integration), never hand-write `dist/wrangler.json`.
2. Read derived keys from `dist/wrangler.json` after `bun run build`.
diff --git a/web/docs/agents/platform/celld.md b/web/docs/agents/platform/cello.md
similarity index 87%
rename from web/docs/agents/platform/celld.md
rename to web/docs/agents/platform/cello.md
index bf9cbd73..f6b167b6 100644
--- a/web/docs/agents/platform/celld.md
+++ b/web/docs/agents/platform/cello.md
@@ -1,6 +1,6 @@
---
-title: Run inside the celld runtime
-description: Follow celld fetch, state, binding, network, and memory rules.
+title: Run inside the Cello runtime
+description: Follow Cello fetch, state, binding, network, and memory rules.
---
## Obey the runtime contract
diff --git a/web/docs/agents/platform/meta.ts b/web/docs/agents/platform/meta.ts
index ecbf139c..1196d01d 100644
--- a/web/docs/agents/platform/meta.ts
+++ b/web/docs/agents/platform/meta.ts
@@ -4,5 +4,5 @@ export default defineMeta({
title: "Platform",
icon: "server",
order: 8,
- pages: ["celld", "config-keys", "limits"],
+ pages: ["cello", "config-keys", "limits"],
});
diff --git a/web/docs/agents/testing/previews.md b/web/docs/agents/testing/previews.md
index 6f42ce45..e01467d4 100644
--- a/web/docs/agents/testing/previews.md
+++ b/web/docs/agents/testing/previews.md
@@ -17,7 +17,7 @@ Trial a change before it goes live: commit with `preview: true` to deploy the sa
## Run the preview loop
1. Commit with `preview: true` to refresh the app's one preview.
-2. Expect the same pipeline as live: install, build, moderation gate, migrations from scratch, then celld deploy.
+2. Expect the same pipeline as live: install, build, moderation gate, migrations from scratch, then Cello deploy.
3. Expect an empty namespace: the preview fleet starts with fresh D1/KV/R2 state and never touches live data.
4. Share the preview URL for click-through; unlisted previews answer `noindex` like live.
5. Promote with `promote_preview` to fast-forward main and deploy normally.
diff --git a/web/docs/frontend/install-on-phones.mdx b/web/docs/frontend/install-on-phones.mdx
index d74633ea..9c3e6baf 100644
--- a/web/docs/frontend/install-on-phones.mdx
+++ b/web/docs/frontend/install-on-phones.mdx
@@ -16,4 +16,4 @@ Two rules keep installs working:
To rename the app on home screens, ask your builder to update the name and the page title.
-For the technical detail, your builder reads [Run inside the celld runtime](/agents/platform/celld).
+For the technical detail, your builder reads [Run inside the Cello runtime](/agents/platform/cello).
diff --git a/web/docs/get-started/console-tour.mdx b/web/docs/get-started/console-tour.mdx
index b1fd6ca6..7060e612 100644
--- a/web/docs/get-started/console-tour.mdx
+++ b/web/docs/get-started/console-tour.mdx
@@ -87,7 +87,7 @@ Owner-only browsers over the app's live bindings:
(back up now, download a dump, restore one).
- **R2** — browse folders, preview text and images, download, upload, and
delete. Reads use the same scoped credentials as the app; writes go
- through celld and are recorded in the agent action log.
+ through Cello and are recorded in the agent action log.
- **Durable Objects** — list instances (read-only). Selecting one shows
what the app's own `?read=1` handler returns. Ask your builder to add that
read-only branch so you can preview state here.
diff --git a/web/docs/reference/tools.md b/web/docs/reference/tools.md
index a3de3bf0..844d925b 100644
--- a/web/docs/reference/tools.md
+++ b/web/docs/reference/tools.md
@@ -17,13 +17,13 @@ Every Outer tool in `tools/list` order, rendered from the registry. Generated
## `docs`
- **Access:** anyone (no token needed)
-- **Description:** Read an Outer agent guide: quickstart, templates, ilha, void, website, celld, d1, storage, backups, kv, auth, cron, queues, websockets, sse, email, sandboxes, limits, moderation, custom-domains, export, previews or look. Read the ilha guide before writing any code.
+- **Description:** Read an Outer agent guide: quickstart, templates, ilha, void, website, cello, d1, storage, backups, kv, auth, cron, queues, websockets, sse, email, sandboxes, limits, moderation, custom-domains, export, previews or look. Read the ilha guide before writing any code.
**Input:**
| Property | Type | Required | Description |
| --- | --- | --- | --- |
-| `topic` | string | yes | Which agent guide to read: quickstart, templates, ilha, void, website, celld, d1, storage, backups, kv, auth, cron, queues, websockets, sse, email, sandboxes, limits, moderation, custom-domains, export, previews or look. |
+| `topic` | string | yes | Which agent guide to read: quickstart, templates, ilha, void, website, cello, d1, storage, backups, kv, auth, cron, queues, websockets, sse, email, sandboxes, limits, moderation, custom-domains, export, previews or look. |
## `whoami`
diff --git a/web/pages/console/_islands/actions/data-do.ts b/web/pages/console/_islands/actions/data-do.ts
index 77612b77..95d08759 100644
--- a/web/pages/console/_islands/actions/data-do.ts
+++ b/web/pages/console/_islands/actions/data-do.ts
@@ -1,5 +1,5 @@
// Durable Objects viewer actions: one registered entry per query the DO
-// panel performs. Read-only end to end — celld exposes no generic storage
+// panel performs. Read-only end to end — Cello exposes no generic storage
// read for a DO instance, so the preview is the app's own `?read=1`
// response and stays blank when the fleet is asleep or the object has no
// read handler.
@@ -71,7 +71,7 @@ const doListInstances: ConsoleAction<{ slug: string; class: string }, DoInstance
name: "do_list_instances",
title: "List Durable Object instances",
description:
- "List the instances of one Durable Object class (id + scope) via `celld cell list`. Reserved celld-internal classes are skipped. Works while the fleet is asleep.",
+ "List the instances of one Durable Object class (id + scope) via `cello cell list`. Reserved cello-internal classes are skipped. Works while the fleet is asleep.",
inputSchema: {
type: "object",
properties: {
diff --git a/web/pages/console/_islands/actions/data-r2.ts b/web/pages/console/_islands/actions/data-r2.ts
index b253b79f..b175e89d 100644
--- a/web/pages/console/_islands/actions/data-r2.ts
+++ b/web/pages/console/_islands/actions/data-r2.ts
@@ -1,6 +1,6 @@
// R2 browser actions: one registered entry per query/mutation the R2 panel
// performs. Reads are S3 under `fleets/{slug}/r2//` with scoped
-// creds; writes and deletes go through `celld r2 put` / `celld r2 delete`
+// creds; writes and deletes go through `cello r2 put` / `cello r2 delete`
// and are audited (client "Console").
import { request } from "./http.ts";
diff --git a/web/pages/console/_islands/data/do/view.tsx b/web/pages/console/_islands/data/do/view.tsx
index e24f061d..e66c5989 100644
--- a/web/pages/console/_islands/data/do/view.tsx
+++ b/web/pages/console/_islands/data/do/view.tsx
@@ -4,7 +4,7 @@
// Outer differences: fetches go through the registered data-do actions,
// the probe runs on selection (not embedded per row — a class with many
// instances lists fast while the fleet still answers each probe
-// best-effort), and the empty copy states that celld has no generic DO
+// best-effort), and the empty copy states that Cello has no generic DO
// storage API: apps opt in to previews by implementing `?read=1`.
import { atom, watch } from "ilha";
@@ -147,7 +147,7 @@ function DoInstancePanel({
{body}
- Read-only. celld keeps an instance's storage in its cell; this preview
+ Read-only. Cello keeps an instance's storage in its cell; this preview
is the app's own ?read=1 response.
@@ -360,7 +360,7 @@ function DoBrowser({ slug, binding }: { slug: string; binding: DoBinding }) {
)}
- Durable Object storage has no generic read API in celld. This viewer
+ Durable Object storage has no generic read API in Cello. This viewer
lists instances and shows each app's own ?read=1{" "}
response — implement that read-only branch to preview state.