Project Settings

Project Settings — rename name / package / folder

The project overview page (/projects/{id}/overview) has a Project settings card for renaming three things.

Display name

Editable at any time. Updates the name column only — no files or IDs change.

Package name (applicationId)

Editable only while the project is idle (no console turn in progress and no build running). On change the server:

1. Updates the project's package_name in the database.
2. Renames the keystore files in /home/vibe/keystores from <old>.keystore (and -debug.keystore, -keystore.properties, -admob.properties) to the new package prefix, rewriting the storeFile path inside the properties.
3. Sends a rename task to the console so Claude updates the code: namespace and applicationId in build.gradle.kts, the src/main/java (and kotlin/test/androidTest) directory structure, all package/import declarations, AndroidManifest.xml, and any signing references.

Watch the console while Claude performs the refactor, then build to confirm.

Folder name (project ID)

The project ID is the workspace folder name and the database primary key, so this is the heaviest change. Editable only while the project is idle.

On change the server:

1. Terminates any live console session (the process holds the old folder as its working directory). The conversation history is preserved in the database and reappears in the renamed project's console.
2. Moves the workspace directories: <root>/<id>, .vibecoder/<id>, and the project keystore directory.
3. Migrates the database primary key in a single transaction — inserts the new project row, repoints project_id in every child table (builds, artifacts, uploaded files, conversation turns, build schedules, webhook secrets, prompt automation runs, notification events), then deletes the old row. If the DB step fails the filesystem move is rolled back.

The new ID must match [a-z0-9][a-z0-9._-]{0,63} and must not already exist.

General Chat / chat ghost projects cannot be renamed.