> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codecobra.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a project
> Set up a new project for your Odoo customizations.
## Create a new project
Click **New Project** from your Projects page or dashboard to start the setup wizard.
Fill in the following:
* **Project name** — a descriptive name like "Sales Customizations" or "Warehouse Automation"
* **Odoo version** — select the version your Odoo instance runs (17.0, 18.0, or 19.0)
* **Edition** — choose Community or Enterprise, matching your Odoo license
* **Workspace** — assign the project to your personal workspace or an organization
If you assign a project to an organization, it will be accessible to team members based on their team permissions. If the organization has teams with "auto-add to new projects" enabled, those teams will automatically be assigned.
If you want CodeCobra to push code directly to your repositories:
1. Toggle on **Connect GitHub**
2. Search for and select your repositories from the list
3. For each repository, choose a **staging branch** (where code goes for testing) and a **production branch** (where final code is deployed)
You can connect multiple repositories to a single project if your Odoo setup uses separate repos for different modules.
If you're just getting started or exploring, you can skip this step entirely. GitHub can be connected later from the project settings at any time. You can still use CodeCobra to explore Odoo features and generate development plans without a repository.
Give the agent direct access to your real Odoo databases over MCP — it
can read records, run searches, and (on the *Write* or *Delete* tier)
change records instead of only working in the disposable onboard pod.
Click **Add Odoo environment**, paste your Odoo URL, pick the database
from the dropdown, and provide a login + API key. CodeCobra will
auto-detect the database when only one exists on the server.
You can add as many environments as you want (e.g. one for *Production*
and one for *Staging*) and skip this step entirely if you'd rather
configure Odoo later from project settings.
See the [full Odoo setup guide](/projects/odoo-environments) for how
to create an API key, choose a tier, and troubleshoot connection
errors.
Review your selections on the summary screen. You'll see:
* Your project name, Odoo version, and edition
* The workspace it belongs to
* Connected repositories with their branch configuration
Click **Create** and your project is ready. You can start creating tasks immediately.
## Choosing the right Odoo version
Make sure you select the Odoo version that matches your actual instance. This matters because:
* CodeCobra writes code that's compatible with your specific version
* Odoo modules and features vary between versions
* API changes between versions can cause modules to be incompatible
If you're unsure which version you're running, check your Odoo instance's **Settings > About** page.
## Supported Odoo versions
CodeCobra supports the following Odoo versions:
| Version | Community | Enterprise |
| ------- | --------- | ---------- |
| 17.0 | Yes | Yes |
| 18.0 | Yes | Yes |
| 19.0 | Yes | Yes |
## Move a project to an organization
If you started with a personal project and later want to share it with your team:
1. Open the project and go to **Settings**
2. Click **Move to Workspace**
3. Select the organization
4. Optionally assign it to a specific team
The project and all its tasks will become accessible to organization members based on their team assignments. Owners and admins can always see all projects; members see only projects assigned to their teams.
## Next steps
Start building or exploring Odoo features within your project.
Set up repository integration for code deployment.
Wire up real Odoo databases the agent can read and write.
Learn what Odoo can do before you start building.