Skip to content
Docs

basemodo rename

Rename an App; its old address redirects to the new one for 30 days.

Terminal window
basemodo rename [OPTIONS] <NAME>

Its address (slug) follows the new name, with a short suffix if another App has it. Links to the old address keep working for 30 days, path and all, and no other App can take it meanwhile. Custom domains are not affected. Deploy it from then on with --name and the new name (or from a folder of that name). Only the App's Owner renames it.

Arguments

  • NAME (required): The new name: lowercase letters, digits and dashes, at most 40.
  • --app <APP>: The App to rename. Default: the one named after the current folder.

Like every command, it also takes the global options --json and --api-url.

Examples

Rename the App of this folder:

Terminal window
basemodo rename team-lunch

Rename another App:

Terminal window
basemodo rename team-lunch --app lunch-rota

Output

With --json, it prints {"app", "previous_url", "redirects_until"}; both null when the address did not change.

From an agent

The local MCP serves it as the tool rename. It changes things, so an agent's client may ask you before it runs. Its arguments are the command's, named as JSON keys: name (text), app (text). It answers what the command prints with --json.

Explained in