• English

      • Remos Bot Guide

      Remos Bot connects your phone to a Markdown Workspace on your computer. A workspace is an existing folder of Markdown files; CLI mode does not require Obsidian. Choose one host:

      • CLI host: run npx remosidian from your Markdown folder.
      • Obsidian plugin: install the free Remos Bot Host plugin from Feishu Download.

      The Obsidian plugin is not listed in the Obsidian community plugin directory — download it directly from the official site above and enable it from your vault's Community plugins settings.

      Start From The CLI

      cd ~/Documents/MyVault
npx remosidian

      Remos Bot starts a local host for the current Markdown workspace, opens a short pairing window, and prints a QR code for the mobile app.

      After installing a CLI version containing the Remos Bot rename, you can also run remos or remos start. The existing npm installation entry is remosidian; npx remosidian remains supported.

      Start From The Remos Bot Host Obsidian Plugin

      Download the free plugin from Feishu Download, then install it into the target vault:

      <your-vault>/.obsidian/plugins/remos-host/
  main.js
  manifest.json
  styles.css   # if included

      Then open Obsidian on desktop, go to Settings -> Community plugins -> Installed plugins, enable Remos Bot Host, open its settings, and click Show QR Code. The plugin is not in the community plugin marketplace — download it from Feishu Download.

      Remote Access

      The CLI enables Remote Direct by default. Add --cloudflare to also enable a Cloudflare Tunnel. Use --access=local for LAN-only pairing, --access=https://<your-url> for your own relay, or --access=<host> for a fixed private-network host. Remote Direct requires the updated mobile app. The Obsidian plugin keeps its existing host configuration.

      npx remosidian --access=local
npx remosidian --cloudflare --force
npx remosidian --access=https://<your-url>
npx remosidian --access=<stable-host>
npx remosidian --access=<host>,<fallback>

      Legacy aliases still work: --local, --relay, --host, --fallback-hosts, --remote, and --tunnel.

      The plugin host is desktop-only because it starts a local server inside Obsidian's desktop process.