Windsurf to Devin Migrator (Free): Move .windsurf Rules and Workflows to .devin

Windsurf is now Devin Desktop. Move your rules and workflows over in one command, and find the ones that never loaded.

Windsurf to Devin Migrator (Free): Move .windsurf Rules and Workflows to .devin product illustration

What it does

Windsurf is now Devin Desktop, and rules, workflows and global rules have new homes. This tool moves an existing Windsurf project to the new layout, repairs the frontmatter that stops rules from loading, and lints the result.

Python 3.9+, standard library only, no network, no API keys. Your old files stay where they are.

Run it

python3 tools/migrate_windsurf.py --project /path/to/repo --dry-run   # see the plan
python3 tools/migrate_windsurf.py --project /path/to/repo             # write .devin/
python3 tools/migrate_windsurf.py --global                            # your Windsurf global rules -> ~/.devin/global_rules.md
python3 tools/devin_rules_lint.py --project /path/to/repo             # check what loads

Try it on examples/windsurf-project/ first: it has every common problem.

What moves where

WindsurfDevin Desktopnotes
.windsurfrules.devin/rules/windsurfrules.md (always_on)or append to AGENTS.md with --rules-to-agents-md
.windsurf/rules/*.md (also nested, e.g. packages/api/.windsurf/rules).devin/rules/*.md next to itfrontmatter repaired: trigger: always → always_on; Cursor/Kiro/Copilot keys (alwaysApply, inclusion, applyTo, fileMatchPattern) converted; a model_decision rule with no description gets its heading
.windsurf/global_rules.md.devin/global_rules.mdwhen both exist only the .devin one loads
.windsurf/workflows/*.md.devin/skills/<name>/SKILL.mdtriggers: [user] so /name still works; --skills-dir .agents/skills to share them with other agents
~/.codeium/windsurf/memories/global_rules.md~/.devin/global_rules.md--global

Devin still reads the legacy .windsurf folders, so nothing breaks while you check the result. Delete the old copies once the lint is clean, because duplicate rules load twice. --fix-frontmatter repairs rules already in .devin/rules and keeps .bak copies. --force overwrites files the migrator wrote before.

What the linter checks

codeproblem
R102unknown or misspelled trigger (always, alwaysOn, glob_match ...)
R103trigger: glob without globs: the rule never loads
R104trigger: model_decision without a description: the agent has nothing to decide on
R105globs on a non-glob rule (ignored)
R106another tool's frontmatter (alwaysApply, inclusion, applyTo) or no trigger at all
R113 / R114inside a path segment (src/.ts); a glob that matches no file in the repo
R107 / R112rules over the old 12,000 / 6,000-character limits; how many always-on characters ride along with every message
R109 / R110 / R111 / R117the same rule in .devin and .windsurf; an ignored .windsurf/global_rules.md; legacy .windsurfrules; workflows still to convert
R116frontmatter in AGENTS.md (it takes plain Markdown)
S200-S208skills: folder name, missing SKILL.md or description, bad triggers, unknown keys, empty instructions

--json for scripts, --strict fails on warnings too. examples/github-workflow.yml runs it on pull requests.

Honest limits

  • Follows the Devin Desktop docs (rules, skills, the Windsurf migration guide) as of November 2026. The product is changing quickly after the rename.
  • It reads and writes files. It doesn't run Devin and can't see rules set in the app's settings UI or Windsurf "memories".
  • Workflows become skills as-is. If a workflow calls another workflow (/release), check that both moved.
  • Not affiliated with Cognition, Devin or Windsurf.

Format and license

Zip, 18 KB, v1.0, 19 files. Free to use, modify and share for any purpose, including commercial work, as long as this notice stays in copies. Not affiliated with Cognition, Devin or Windsurf.

FAQ

Does it delete my .windsurf files?
No. It only writes the new .devin files and never overwrites without --force. Delete the old copies once the lint is clean.
What happens to workflows?
Each becomes .devin/skills/<name>/SKILL.md with triggers: [user], so /name keeps working.
Is it really free?
Yes, the whole tool. The paid Windsurf & Devin Rules Pack is optional.
How do I get the files?
Click Download free. The zip downloads straight away: no checkout, no account.
Do I have to sign up for the newsletter?
No. The form is optional and the download works without it.

Get Windsurf to Devin Migrator (Free): Move .windsurf Rules and Workflows to .devin

Free Windsurf to Devin Desktop migrator: moves .windsurfrules, .windsurf/rules, global rules and workflows to .devin, repairs frontmatter, lints the result.

Pairs well with

Download$119

Agent Builder Bundle

Swarm Operator Kit + x402 Builder Skills + MCP Starter Kit. $119 instead of $157.

View Agent Builder Bundle
Download$89

Swarm Operator Kit

Run a team of AI agents as a business: charter, 5 roles, 6 skills, routines and scripts.

View Swarm Operator Kit
Download$19

n8n Agent Workflows

6 import-ready n8n workflows: x402 monitor, change alerts, Stripe log, AI digest and more.

View n8n Agent Workflows

Related

1 email a week: new x402 + MCP tools and free kits.

Short weekly digest of new x402 + MCP tools and free kits, including the MCP OAuth Checker. The download above works without signing up. No spam, unsubscribe any time.