Skip to content
Docs
Start free

Edit a folder on your computer

Local folder mode opens a site you've cloned on your computer in Xodia. The editor runs in your browser; the preview and every file change run on your machine, in your folder, with your own git. It uses no preview hours.

On this page

Settings, Code and Git: beside the GitHub repository, Open on this computer shows the xodia dev command to run in the site's folder, with a one-time code that works for 15 minutes.

Before you startLink to this section

  • Node.js 22 or newer on your computer.
  • The site cloned as a git repository.
  • The project in Xodia. Local folder mode is on every plan. Every plan

Open your folder in XodiaLink to this section

  1. Get the command

    In the project's Settings, open Code and Git and choose Get the command.

  2. Run it in your site's folder

    Paste it in a terminal in your site's folder, inside its git repository. npx fetches the xodia tool from Xodia the first time; there is nothing else to install.

  3. Edit as usual

    The project switches to your folder as soon as it connects. Edit in Xodia and in your own editor side by side.

The command looks like this, with your own one-time code in place of the one below:

Terminal
npx -y --package=https://app.xodia.ai/cli/xodia-0.2.7.tgz xodia dev --connect <code> --server https://app.xodia.ai

The code works once, for 15 minutes. After the first time, xodia dev reconnects on its own. The pairing stays on your computer and out of your repository.

Where your changes goLink to this section

Into the files in your folder. You commit and push with your own git, the way you always do.

Go back to the cloud previewLink to this section

In Settings, Code and Git, choose Back to the cloud preview. The project previews on Xodia again.

Tip:

Want to run requests from the ask box with Claude Code on the same computer? That's the Xodia helper: see The Xodia helper.