Skip to content
aix

Windsurf support details

Native rules, workflows, skills, and hooks, but MCP remains global-only.

Windsurf is strongest when project rules matter more than project-scoped MCP.

Start on the full support matrix when you need to compare every editor at once. Use this page when you want the exact terms, support details, and project/user targets for Windsurf.

Related aix concepts: rules , prompts , mcp , skills , hooks .

Editor-specific notes

  • Windsurf MCP installs are tracked as global state because the editor only supports global MCP today.
  • Its prompt surface is called workflows, not commands.

Feature details

How to read the statuses

Support key

Editor support

  • Supported The editor exposes that feature at that scope.
  • No support The editor does not expose that feature at that scope.

aix support

  • Native aix writes the editor's own format.
  • Adapter aix keeps the feature through an adapter or alternate representation.
  • No support aix does not write that feature for the destination today.

Use the Project scope and User scope rows to see where config lands at each level.

Rules Learn the concept

Markdown rule files with Windsurf trigger frontmatter.

Windsurf calls this Rules
aix support Native
Project
Editor Supported aix Native
Path .windsurf/rules/*.md
User
Editor Supported aix Native
Path ~/.codeium/windsurf/memories/global_rules.md

Supported metadata: always_on , model_decision , glob , manual

Prompts Learn the concept

Markdown workflow files with YAML frontmatter.

Windsurf calls this Workflows
aix support Native
Project
Editor Supported aix Native
Path .windsurf/workflows/*.md
User
Editor Supported aix Native
Path ~/.codeium/windsurf/global_workflows/*.md

Supported metadata: description

MCP Learn the concept

Global-only JSON MCP configuration.

Windsurf calls this MCP servers
aix support Native
Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Windsurf does not have a project-scoped MCP config file in aix.
User
Editor Supported aix Native
Path ~/.codeium/windsurf/mcp_config.json
  • Project-scoped syncs report MCP as a skipped global-only write.

Skills Learn the concept

Symlinked native skill directories backed by .aix/skills/.

Windsurf calls this Skills
aix support Native
Project
Editor Supported aix Native
Path .windsurf/skills/{name}/
User
Editor Supported aix Native
Path ~/.windsurf/skills/{name}/
  • Windsurf also discovers .agents/skills/ for compatibility.

Agents

Windsurf does not document custom agent files that aix can write safely.

Windsurf calls this Agents
aix support No support
Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix reports configured agents as unsupported for Windsurf.
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix reports configured agents as unsupported for Windsurf.

Hooks Learn the concept

JSON hook configuration using snake_case Windsurf event names with cross-platform command / powershell fields.

Windsurf calls this Hooks
aix support Native
Project
Editor Supported aix Native
Path .windsurf/hooks.json
User
Editor Supported aix Native
Path ~/.windsurf/hooks.json

Supported metadata: post_cascade_response , post_cascade_response_with_transcript , post_mcp_tool_use , post_read_code , post_run_command , post_setup_worktree , post_write_code , pre_mcp_tool_use , pre_read_code , pre_run_command , pre_user_prompt , pre_write_code

  • Each hook entry can carry command (bash) and/or powershell for cross-platform routing.
  • Pre-hooks block actions with exit code 2; post hooks cannot block.

AGENTS.md

Compatibility with AGENTS.md and agents.md repository files.

Windsurf calls this AGENTS.md
aix support Native
Project
Editor Supported aix Native
Path AGENTS.md or agents.md in the workspace
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Windsurf documentation focuses on workspace files, not a home-scoped AGENTS.md.

.agents/skills

Compatibility with the shared Agent Skills folder convention.

Windsurf calls this .agents/skills
aix support Native
Project
Editor Supported aix Native
Path .agents/skills/{name}/
User
Editor Supported aix Native
Path ~/.agents/skills/{name}/

Related guides