Your first project
A project is one app: its chats, its plan and a folder of real files on your Mac.
Create a project
On the welcome screen, choose Create a new app, or press ⌘N, and give it a name.
Commandr makes a folder for it in your projects folder — todo-list, say — with its own git repository. If you haven’t picked a projects folder yet, it asks first. Change it any time in Settings → Workspace; existing projects stay where they are.
Git needs to be installed. If it isn’t, run xcode-select --install in Terminal.
Tell Scope your idea
Every agent’s chat opens with a short welcome: what it does, and three suggested first messages. Start with Scope: describe what you want to build, and it turns your idea into a clear build scope, asking questions where it needs to.
Picking a suggestion puts it in the message box for you to edit. Nothing is sent until you press ↩.
From plan to files
The planning agents work in the chat: Audit checks the scope for gaps, Wireframe maps the screens, Design creates the design system, and Architect settles the stack. Architect asks about your framework, libraries and package manager before it writes a plan.
Below Architect’s plan, click Create project files. Commandr adds the folders and files to your project — never overwriting one that’s already there — fills in the package manifest and, if you’ve allowed project commands, installs the dependencies. Frontend and Backend then write the real code into the folder.
Or run the whole pipeline
Instead of going agent by agent, choose Run pipeline. Commandr works through every stage, hands each one’s output to the next, and pauses when an agent needs your answers. See The pipeline.
Opening the files
Open the folder in Finder, VS Code or Cursor from Project settings → Folder. Deleting a project in Commandr keeps its folder on disk.