Skip to main content

​
Create a new project

Click New Project from your Projects page or dashboard to start the setup wizard.
1

Set the basics

Fill in the following:
  • Project name — a descriptive name like “Sales Customizations” or “Warehouse Automation”
  • Odoo version — select the version your Odoo instance runs (16.0, 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 a workspace
A project assigned to a workspace is available to every member of that workspace. Only workspace owners and admins can create workspace projects.
2

Connect GitHub (optional)

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.
3

Connect Odoo (optional)

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 for how to create an API key, choose a tier, and troubleshoot connection errors.
4

Review and create

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:

​
Move a project to a workspace

If you started with a personal project and later want to share it with your team:
  1. Open the project and go to Settings → Danger zone
  2. Click Transfer ownership
  3. Pick the workspace and click Confirm Transfer
Only workspaces where your role can delete & transfer projects (owners and admins, by default) are offered. The same steps move a project from one workspace to another, or back to your personal account by picking Personal. Nothing is deleted, but a project can’t be moved to another person’s account. The project and all its tasks become accessible to every member of the workspace. To share it with someone outside the workspace, add them under Settings → People & access.
Moving a workspace project removes its outside collaborators and project-specific roles; you’ll be asked to confirm first. Usage already billed stays with whoever paid for it, and new usage is billed to the project’s new owner.

​
Next steps

Create a task

Start building or exploring Odoo features within your project.

Connect GitHub

Set up repository integration for code deployment.

Connect Odoo

Wire up real Odoo databases the agent can read and write.

Explore Odoo

Learn what Odoo can do before you start building.