Skip to content
Crosswalker
🚧 Early alpha — building the foundation. See the roadmap →

Installation

Updated

Requirements

Section titled “Requirements”

Crosswalker requires Obsidian 1.10.0 or newer. This minimum is based on the Obsidian APIs the plugin uses; it is not a claim of execution testing on version 1.10.0. The current prerelease candidate was tested on Obsidian 1.13.7 on desktop Linux. Mobile use is not yet verified.

Enable the built-in Bases plugin if you want to use Crosswalker’s pivot views.

From community plugins (coming soon)

Section titled “From community plugins (coming soon)”

Crosswalker is not yet listed in the Obsidian community plugins registry. Once submitted, you’ll be able to install it directly from Settings > Community Plugins.

Prerelease installation through BRAT

Section titled “Prerelease installation through BRAT”

Crosswalker ships as GitHub prereleases (0.1.0 published 2026-09-13, 0.1.1 published 2026-09-14, 0.1.2 published 2026-09-23, 0.1.3 published 2026-09-24, 0.1.4 published 2026-09-24, 0.1.5 published 2026-09-29; 0.1.6 is the current candidate). An actual BRAT installation has not yet been tested by the maintainer; if BRAT reports a problem, the manual installation steps below use the same three release files.

  1. Install and enable the BRAT community plugin
  2. In BRAT, choose Add a beta plugin
  3. Enter cybersader/crosswalker
  4. Choose the latest available release, or select 0.1.6 when BRAT offers version selection
  5. Enable Crosswalker in Settings > Community Plugins

Already added through BRAT? Use BRAT’s Check for updates to move to a newer prerelease.

Back up your vault first and try the prerelease in a test vault before using it with important data.

Manual installation

Section titled “Manual installation”
  1. Download main.js, manifest.json, and styles.css from the selected Crosswalker release
  2. Create a folder: your-vault/.obsidian/plugins/crosswalker/
  3. Copy the three files into that folder
  4. Open Obsidian, go to Settings > Community Plugins
  5. Enable “Crosswalker”

Get a framework file

Section titled “Get a framework file”

Crosswalker does not bundle publisher framework content. Use the framework data sources guide to obtain a supported CSV, XLSX, or JSON source and check its licence posture, matching recipe, worksheet, header row, and known import gotchas. Then follow the quick start.

From source

Section titled “From source”
git clone https://github.com/cybersader/Crosswalker.git
cd Crosswalker
bun install
bun run build

Copy main.js, manifest.json, and styles.css to your vault’s plugin folder.