Organize simulation work into dedicated project workspaces.
Projects let you group related simulation chats into a single workspace with shared settings, custom instructions, and solver configuration. They are the primary organizational unit in SimPilot.
Creating a project
Open the project panel
Click the Projects section in the sidebar, then click New Project.
Set name, icon, and color
Give your project a descriptive name (e.g., "HVAC Duct Optimization"). Choose an icon and accent color to make it visually distinct in the sidebar.
Add custom instructions
Write project-level instructions that the AI will follow in every chat within this project. For example: "Always use the k-omega SST turbulence model" or "Report results in imperial units."
Configure solver settings
Set the default solver type, solver version, and compute runtime for all simulations in this project.
Project structure
Each project contains:
Multiple chats -- Every conversation you start within the project is grouped together. You can switch between chats in the sidebar.
Custom instructions -- Persistent context the AI sees in every message, so you don't have to repeat project-specific requirements.
Solver settings -- Default solver type (e.g., simpleFoam, interFoam), solver version, and compute runtime that apply to all simulations unless overridden in a specific chat.
Case status tracking
Every simulation case within a project has a status indicator showing where it is in the pipeline:
Status
Description
Idle
Case is set up but has not been submitted
Meshing
Computational mesh is being generated
Solving
Solver is running on cloud compute
Post-processing
Results are being processed for visualization
Complete
Simulation finished successfully
Error
Something went wrong -- check the error details in the chat
Real-time updates
Status indicators update in real time. You can navigate away from the chat and the sidebar badge will show the current state of every case.
Project-level solver configuration
Solver settings defined at the project level act as defaults for every new simulation in that project. This is useful when all your cases share the same solver type or runtime requirements.
You can override any project default in a specific chat by telling the AI (e.g., "use pisoFoam instead of simpleFoam for this run") or by changing settings in the case configuration panel.
Export
Export an entire project -- including all chats, case files, and results -- for archiving or sharing with colleagues. The export produces a structured archive you can re-import or inspect offline.
When to use projects
Use projects when you are working on a series of related simulations -- for example, a parametric study, a design comparison, or a multi-physics campaign. For one-off explorations, a standalone chat works just fine.