Creating Your Project
Click the Create Project button to choose from two options:- From existing git repository: Browse your file system and select from a list of git repositories sorted by recent activity
- Create blank project: Generate a new git repository from scratch Each project represents a git repository. After creation, you can configure it with setup scripts, dev server scripts, and other settings.
After creating a project, you need to press the settings button in the top right to configure project scripts and settings.
Project Settings
Once you’ve created a project, you can access the project settings by clicking the settings button in the top right corner. From here, you can configure various aspects of your project.Setup Scripts
Setup scripts will be run before the coding agent is executed. This is useful for installing dependencies, for example you might runnpm install or cargo build. This will save you time as your agent won’t need to figure out that these commands haven’t already been run.
Each time a coding agent is executed it runs in a git worktree which is unlikely to contain your dependencies, configs, .env etc.
Dev Server Scripts
The dev server script is run whenever you press the “run dev server” button. It’s useful for quickly reviewing work after a coding agent has run.Cleanup Scripts
Cleanup scripts run after a coding agent finishes it’s turn. You can use these to tidy up the workspace, remove temporary files, or perform any post-execution cleanup. For example, you might runnpm run format to ensure your code is formatted correctly. Treat it like a pre-commit hook in git.
Copy Files
Comma-separated list of files to copy from the original project directory to the worktree. These files will be copied after the worktree is created but before the setup script runs. Useful for environment-specific files like.env, configuration files, and local settings.
Make sure these files are gitignored or they could get committed!