agentsmesh.yaml

agentsmesh.yaml is the main project configuration file. It is created by agentsmesh init and committed to the repository.

Minimal config

At minimum, set version and at least one target. Every feature is enabled by default, so this is enough to run agentsmesh generate:

version: 1
targets:
  - claude-code
  - cursor

Everything else — features, extends, collaboration, overrides, and conversions — is optional. The full example below shows them all.

Full example

version: 1

# Which tools to generate config for
targets:
  - claude-code
  - cursor
  - copilot
  - gemini-cli
  - cline
  - codex-cli
  - windsurf
  - continue
  - junie
  - kiro

# Which features to sync (all enabled by default)
features:
  - rules
  - commands
  - agents
  - skills
  - mcp
  - hooks
  - ignore
  - permissions

# Inherit shared config from other sources
extends:
  - name: company-standards
    source: github:my-org/ai-config@v1.0.0
    features: [rules, commands, permissions]

# Team collaboration settings
collaboration:
  strategy: merge
  lock_features:
    - mcp
    - permissions

# Per-target overrides
overrides:
  cursor:
    features: [rules, commands, agents, skills, mcp]

# Feature projection behavior
conversions:
  commands_to_skills:
    codex-cli: true
  agents_to_skills:
    cline: true
    windsurf: true

Top-level fields

Field	Type	Required	Description
`version`	`number`	Yes	Config schema version. Currently `1`.
`targets`	`string[]`	Yes	Tool IDs to generate config for.
`features`	`string[]`	No	Features to sync. Omit to enable all.
`extends`	`array`	No	Shared config sources to inherit from.
`overrides`	`object`	No	Per-target config overrides.
`collaboration`	`object`	No	Team collaboration and lock settings.
`conversions`	`object`	No	Control feature projection per target.

targets

Sample starter config (curated subset):

targets:
  - claude-code    # Claude Code (.claude/)
  - cursor         # Cursor (.cursor/)
  - copilot        # GitHub Copilot (.github/)
  - gemini-cli     # Gemini CLI (.gemini/)
  - cline          # Cline (.cline/)
  - codex-cli      # Codex CLI (AGENTS.md)
  - windsurf       # Windsurf (.windsurf/)
  - continue       # Continue (.continue/)
  - junie          # Junie (.junie/)
  - kiro           # Kiro (.kiro/ + AGENTS.md)

See the supported tools matrix for every valid built-in target ID. Plugin targets installed via agentsmesh plugin add are also valid.

features

features:
  - rules        # .agentsmesh/rules/*.md
  - commands     # .agentsmesh/commands/*.md
  - agents       # .agentsmesh/agents/*.md
  - skills       # .agentsmesh/skills/*/SKILL.md
  - mcp          # .agentsmesh/mcp.json
  - hooks        # .agentsmesh/hooks.yaml
  - ignore       # .agentsmesh/ignore
  - permissions  # .agentsmesh/permissions.yaml

Omitting features enables all features. Specifying a subset disables all others.

overrides

Per-target overrides narrow the features or targets for a specific tool:

overrides:
  # Only generate rules and MCP for Codex CLI
  codex-cli:
    features: [rules, mcp]
  # Override targets for a specific downstream use (unusual)
  cursor:
    features: [rules, commands, agents, mcp, ignore]