Skip to content
Strata/Docs
Sign In

CLI Installation

The Strata CLI lets you keep your Spaces on disk as Markdown, on macOS and Linux. The simplest install is the download page, which detects your OS; the commands below do the same from the terminal.

MACOS

Install on macOS

Homebrew

One command. Brew handles the tap, the .pkg, and future updates.

bash
brew install --cask strata-space/tap/strata

Update later with brew upgrade --cask strata.

Direct .pkg installer

Download the signed universal .pkg and double-click to install. The postinstall script adds strata to /usr/local/bin so it lands on your PATH.

MACOS · MOUNT

macOS mount permission

Only needed for strata mount on macOS. The recommended strata link sync needs none of this. macOS hides the FSKit toggle behind a slightly non-obvious view:

  1. Open System Settings.
  2. Go to General → Login Items and Extensions.
  3. Scroll to Extensions and click File System Extensions.
  4. Switch the view from "By App" to By Category. Strata does not appear in the By App list.
  5. Toggle Strata on under File System Extensions.
System Settings Extensions panel with By Category selected, showing Strata listed under File System Extensions.
By Category view of System Settings → Extensions. Strata appears under File System Extensions.
LINUX

Install on Linux

The Linux build is a single binary in a gzipped tarball. Pick the right architecture, extract, and move the binary onto your PATH.

aarch64

bash
curl -L https://github.com/strata-space/strata/releases/latest/download/strata-linux-aarch64.tar.gz | tar -xz
sudo install -Dm755 strata /usr/local/bin/strata
sudo install -Dm644 libstrata_fuse.so /usr/local/lib/strata/libstrata_fuse.so
rm strata libstrata_fuse.so
strata --version

x86_64

bash
curl -L https://github.com/strata-space/strata/releases/latest/download/strata-linux-x86_64.tar.gz | tar -xz
sudo install -Dm755 strata /usr/local/bin/strata
sudo install -Dm644 libstrata_fuse.so /usr/local/lib/strata/libstrata_fuse.so
rm strata libstrata_fuse.so
strata --version

Requires glibc 2.28 or later.

VERIFY

Verify the install

After installing, confirm the CLI is on your PATH and reports a version.

bash
strata --version
USAGE

Working with a Space on disk

Once the CLI is installed, there are three ways to bring a Space onto your machine as Markdown.

Live sync (recommended)

Keep a local folder in live two-way sync: read and write, CRDT-merged, the same on macOS and Linux. Installs a supervised background service by default; add --foreground to run it in your terminal.

bash
strata link ~/my-space --space <space-id>

Mount as a drive

Mount a Space as a live virtual filesystem. Linux uses FUSE (read and write); macOS uses FSKit (read-only, and needs the one-time permission below).

bash
strata mount <space-id> ~/strata

One-time copy

Download or upload once, with no background process.

bash
strata sync pull <space-id> ~/my-space
REFERENCE

Next steps

The download page covers the GUI install for non-terminal users. All historical builds, changelogs, and signed checksums are on GitHub Releases.