Convert a local project using MCP

Beta. Use a stdio MCP client when the source is on your machine. Open the original project’s directory before connecting.

1. Configure OwlMeans MCP for your coding agent and sign in.
2. Open the source workspace. Use --project-dir when you need to specify the directory explicitly.
3. Ask the agent to inspect the source and summarize its intended behavior.
4. Start intake with convert_project, supplying a name and about description. Record the returned project identifier.
5. Read conversion_status for that project. Use check_convertible only after an intake project exists.
6. Review the verdict, proposed work and estimate with a person before proceeding.
7. Use proceed_conversion for the next supported decision, with confirmation only after the person agrees.
8. Keep the coding agent and its MCP connection open while local source work runs. Handle next_question when status says it is waiting for a person.

Local conversion can ask permission to move the source into __viable_converted/ and build the new app around it. Read the question before approving. The original files stay available in that directory; declining stops this conversion.

For a local source tree, start from the workspace with --target local and omit repoUrl:

{
  "name": "Task conversion practice",
  "about": "A small task app with creation, completion and filtering",
  "confirm": true
}

Set confirm: true only after approving the displayed action and any credit conditions.

For a repository-backed intake, convert_project accepts repoUrl and branch. A supplied repository URL takes precedence over the working directory. Check that choice before starting.

{
  "name": "Task conversion practice",
  "about": "A small task app with creation, completion and filtering",
  "repoUrl": "https://github.com/mdn/todo-react",
  "branch": "main",
  "confirm": true
}

Verify the branch against the current repository before using this example. Read the conversion tool reference for exact arguments and availability. Keep originals and license notices until verification is complete.

Names and marks

OpenAI, ChatGPT and related OpenAI marks belong to OpenAI; Codex is an OpenAI product. Usage policy.

Claude and Claude Code are Anthropic products; their names and marks remain with their respective owner. Usage policy.

Node.js, npx names and any associated marks remain with their respective owners or project maintainers. References identify products, standards or source examples. OwlMeans documentation does not imply sponsorship or endorsement by those owners.