Repository (of repo)

Manage Git repositories registered in your project.

of repo ls [env]

Git audit — shows branch, pending pulls, and status for all repos.

Flag	Default	Description
--json	false	JSON output

of repo add [url]

Register a repository in project.yml, clone it, and auto-update the Odoo app list. Logs an ### Added entry in the project's CHANGELOG.md.

Argument	Description
url	Git repository URL

Flag	Default	Description
--env, -e	main	Target environment
--branch, -b	default branch	Git branch
--rev	—	Tag or commit SHA (takes precedence over branch)
--token, -t	—	Auth token — use ${VAR} references
--db	from .env DB_NAME	Database to refresh the Odoo app list
--json	false	JSON output

Empty repositories

If the repository has no commits (just created), Odoofly clones it without a branch, removes the default main branch, and creates the project branch (e.g. 18.0). This way the first git push creates the correct branch on the remote.

of repo rm [url_or_name]

Remove a repository from project.yml (local files in addons/ are NOT deleted for safety).

Argument	Description
url_or_name	Repository URL or name

Flag	Default	Description
--env, -e	main	Target environment
--json	false	JSON output

of repo auth

Interactive token setup for repositories using ${VAR} placeholders.

Scans all repositories in the environment, detects unresolved ${VAR} tokens, and prompts for each value. Values are saved to the environment's .env file with hidden input.

Flag	Default	Description
--env, -e	main	Target environment
--json	false	JSON output

# Fill tokens for the main environment
of repo auth

# Fill tokens for a staging environment
of repo auth --env staging