Skip to content

sync

Fetch capability sources and regenerate provider files.

Terminal window
omnidev sync
  1. Downloads/updates capabilities from configured sources
  2. Resolves capability dependencies
  3. Generates provider-specific files (CLAUDE.md, AGENTS.md, etc.)
  4. Runs any sync hooks defined by capabilities

Run omnidev sync after:

  • Changing omni.toml configuration
  • Enabling or disabling capabilities
  • Switching profiles
  • Updating capability sources

During sync, you may see warnings about version issues:

Syncing...
✓ my-cap
✓ other-cap
! third-cap: no version specified, defaulting to latest
WarningMeaning
no version specified, defaulting to latestSource config missing version field
version unchanged but content changedRepository updated but capability version stayed same

To resolve, consider adding explicit versions to your capability sources:

[capabilities.sources]
my-cap = { source = "github:user/repo", version = "v1.0.0" }

See Capability Sources for more details.