How Do I Safely Migrate from Classic to RepoPrompt CE?
Treat the move as setting up a different application and verifying the workflows you need. RepoPrompt CE is the active community codebase, but it is not a feature-for-feature replacement for Classic. Keep your working Classic setup and backups until you have confirmed that RepoPrompt meets your needs.
The simple answer: Ask your favorite AI harness to do it for you. Or...
1. Preserve your work before changing anything
Finish or stop active coding sessions, then back up your project folders, including uncommitted work and local files you need. A Git commit does not preserve ignored files, application settings, or credentials.
Quit Classic before copying its application data. Preserve its installed app, saved workspace data, custom storage location if you use one, and custom prompts or workflow files. Keep a macOS backup that includes the Keychain rather than copying secrets into a plaintext migration note.
Record which features and external clients you rely on. The Classic documentation archive remains available for reference. Its Classic 2.1.0 label is an archive label, not necessarily the version of your installed application.
2. Install RepoPrompt and start with one project
Follow Installation and start with the Stable channel unless you specifically need a Tip change. Keep the Classic installation available while evaluating RepoPrompt. Check that you launched the intended app before changing settings or reconnecting clients.
Do not replace RepoPrompt CE's application-data directory with Classic's directory or assume that copying a preferences file migrates every workspace, conversation, and setting. RepoPrompt CE's preference and storage migrations serve specific schemas and application identities; they are not a general guarantee of Classic compatibility.
3. Reconnect providers and credentials
Use Providers & Models to configure the coding runtime and the model connections your workflow needs. Check Oracle and Context Builder choices separately. A working CLI login does not automatically configure direct API access.
Credential Recovery covers known legacy RepoPrompt CE accounts only; it does not import Classic credentials. When moving from Classic, authenticate with the provider through CLI Providers, or re-enter your API credential through API Providers, as appropriate for your connection.
API keys and tokens can grant access to your accounts and paid services. Do not paste them into AI conversations, public issues, screenshots, or plaintext migration notes. Use the provider's sign-in flow or the intended credential field in Settings. If a credential is exposed, revoke it with the provider and create a replacement.
Validate the connection before changing or removing old credentials. Keep legacy values while you still need rollback access; deleting a local key is different from revoking it with the provider.
Do not reset your Keychain, delete unrelated entries, or broaden access permissions to complete this migration; those changes can affect other applications and accounts. Check the requesting application and intended item before approving access. If you are unsure, cancel and use the provider's current sign-in or credential-entry controls instead.
4. Reconnect external tools and review custom prompts
Generate a new MCP configuration from the RepoPrompt app for each external client. Follow MCP Setup, rather than reusing Classic executable paths or command examples. Check which integration is enabled, verify the RepoPrompt connection, and bind the intended project before asking the client to work. Avoid letting Classic and RepoPrompt sessions edit the same checkout at the same time.
Install the matching RepoPrompt workflow instructions when needed; connecting MCP alone does not install their skill folders or prompt files. Review custom prompts for old tool names, XML-editing instructions, paths, and assumptions about Classic features.
RepoPrompt has Import Prompts and Export Prompts under Advanced → Saved Prompts. Import requires a compatible format; it is not a whole-application restore. Preserve the original export, inspect imported content, and copy prompt text manually if the old format is unsupported. Recreate the settings you need instead of assuming every old preset has an equivalent.
5. Verify a small workflow
Start with a bounded request such as explaining a function without editing files. Confirm the selected provider, project path, returned context, and any usage charges. Then try a small, isolated change and inspect its diff and validation results.
Check the features you actually use: Context Builder, Oracle, manual context copying, and approval behavior. Keep Classic for a workflow you still need if RepoPrompt does not provide an equivalent.
6. Retire the old setup only after verification
Once your normal work succeeds in RepoPrompt, you can remove obsolete client integrations and decide whether to retain the Classic app. Keep dated backups of its data and exported prompts. Uninstalling an app is not a substitute for checking which configurations and credentials your external tools still use.
If you return to Classic, use its preserved data or backup; do not overwrite it with RepoPrompt data and assume backward compatibility. Project-file changes remain project changes regardless of which app created them. Review or restore those separately.
RepoPrompt does not require an old paid license. See What Happened to the Paid Version? for the transition history and Issue Reporting if a reproducible migration problem remains.