Skip to content
Commandr

Import an existing project

Commandr can work on code you already have. Importing a folder turns it into a project where it is — nothing is copied, moved or overwritten.

Import a folder

  1. Choose Improve an existing project on the welcome screen, or Import existing project… in the project menu, or press ⌘O.
  2. Pick the folder.
  3. Commandr reads its manifests, lockfiles, scripts, README and layout, and pins a summary as Existing code knowledge that every agent receives.

Edit that summary in Project settings → Knowledge. The pipeline starts by asking what you want to change.

Monorepos and git

If the folder isn’t in a git repository, Commandr creates one. If it already is — an app inside a monorepo, say — Commandr uses that repository instead of making a new one.

Before you start

  • Agents can read and write the folder straight away. Checkpoints let you undo their changes — see Checkpoints and undo.
  • Add any folders agents shouldn’t change, like migrations/, to Protected files.
  • Running your scripts and tests needs project commands turned on for the folder.