Skip to content
Guides

Words

One word per thing, per verb and per state, in every tool and every guide.

aeria uses one word for each thing, verb and state: the same in its tools, their answers, the web app and these guides.

Word What it is
workspace what your work belongs to: its members, apps, artifacts, connections, events, billing
member a person of a workspace: owner or member
grant an MCP client you allowed for one workspace
sign-in your signed-in browser on app.aeria.dev; never called a session
event one tool call, or one line of an exec, kept in order
level a tool’s in a workspace: allow, ask, deny
held a call at ask, paused until you allow or deny it
slug a workspace’s, an app’s, an artifact’s name in hosts: set at creation, never changed
Word What it is
app a service a workspace hosts, made from the seed
seed the app every app starts from
session an app’s open branch, or an artifact, with its sandbox
branch an app’s line of work off main: a session
preview a branch running on its own host, never production
production an app’s main, running at <app>-<workspace>.aeria.run
bundle a build’s output: the Worker’s modules and its migrations
deployment one bundle uploaded as an app’s production
promote a branch merged into main, its bundle a deployment
close a branch ended: promoted, or closed (app_branch_close); then purged
purge a closed branch’s preview, sandbox and snapshots deleted
archive hidden, nothing deleted
restore production’s data back to a point in time
load a backup put into a preview’s database
schedule an app’s code run at its cron expression
namespace a group of an app’s callers (its users, grants, tenancy)
tenant a group of a namespace’s users whose rows are theirs
Word What it is
sandbox a session’s container: where its code is written, tested and built
exec one run of aeria’s steps in a sandbox
line one line of an exec’s output: an event of its call
snapshot a sandbox’s whole disk, kept when it stops, restored at its next start
repository an app’s or an artifact’s git, in Cloudflare Artifacts
Word What it is
artifact what your agent makes beyond its answer: a page, a PDF, a sheet, an email, a video
kind an artifact’s type: page, pdf, email, excel, video
version an artifact’s kept build, numbered
save an artifact’s build kept as its next version
unarchive an artifact found again
connection a workspace’s link to an outside service
operation one call of a connection’s or an app’s API, a tool
egress the Worker that puts a secret in place of its placeholder, toward the secret’s hosts only
Word What it is
plan a workspace’s fee, quota, limits and rates
quota the usage a plan’s fee brings, pooled across the workspace
seat a member past the first, paying the plan’s fee
balance a workspace’s prepaid credit
top-up credit bought with the card
reload a top-up charged automatically under a set floor
spending limit what a workspace may spend a month, set by the owner
meter one kind of usage, metered and priced
ledger a workspace’s every credit and debit
Word What it is
operator one of aeria’s own staff: reviews published apps, takes a host down and reinstates it
takedown a host no longer served, by an operator; nothing deleted
reinstate a taken-down host served again