Open Agent Toolkit
Provider Sync

Providers

Provider Quick Browse

  • Project: .agents/skills -> .claude/skills, .agents/agents -> .claude/agents, .agents/rules -> .claude/rules
  • User: ~/.agents/skills -> ~/.claude/skills, ~/.agents/agents -> ~/.claude/agents
  • Rule files stay .md and are rendered with Claude-compatible frontmatter when needed

Scope rules

  • Project scope: skills + agents + rules
  • User scope: skills + agents (provider mappings vary by adapter)
  • Rules are project-scoped only in this release
  • Codex user-scope role generation under ~/.codex remains deferred in this release

Adoption model

  • Stray adoption is available in oat init and oat status.
  • Adoption reconciles canonical plus the adopted provider first.
  • Rule adoption normalizes provider filenames back to canonical .agents/rules/*.md entries before cross-provider fanout.
  • Cross-provider fanout is explicit via oat sync --scope all.

Reference artifacts

  • .oat/projects/<scope>/<project>/spec.md (FR5)
  • packages/cli/src/providers/**
  • packages/cli/src/providers/shared/adapter.utils.ts

Provider Sync Overview

Plain-language explanation of canonical assets, provider views, and the first-sync loop.

Provider Interop CLI Scope and Surface

Scope boundaries and design principles for canonical-to-provider asset management.

On this page

ProvidersProvider Quick BrowseScope rulesAdoption modelReference artifacts