Skip to content

Import from an Editor

If you already have rules, MCP servers, or other AI config in your editor, aix init --from can convert it into an ai.json for you.

Terminal window
aix init --from <editor>

Supported editors:

EditorFlag value
Cursorcursor
VS Codevscode
Claude Codeclaude-code
Windsurfwindsurf
Zedzed
Codexcodex

aix reads the editor’s existing config files and extracts:

  • Rules.cursorrules, .windsurfrules, .github/copilot-instructions.md, etc.
  • MCP servers — from the editor’s MCP config JSON
  • Prompts — custom prompt files if the editor stores them
  • Skills — any SKILL.md references

Imported content is written to .aix/imported/ and referenced from ai.json:

{
"rules": {
"imported-cursor": {
"path": ".aix/imported/rules/cursor.md"
}
},
"mcp": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}

If ai.json already exists, aix init --from will refuse to overwrite it. Use --force to override:

Terminal window
aix init --from cursor --force

After importing, review the generated ai.json and clean up anything that doesn’t apply across editors. Then run:

Terminal window
aix install

This syncs the config to all your detected editors — including the one you originally imported from.