# 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](/content/download/index.html), which detects your OS; the commands below do the same from the terminal.

## 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 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.

By Category view of System Settings → Extensions. Strata appears under File System Extensions.

## 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 the install

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

```bash
strata --version
```

## 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
```

## Next steps

The [download page](/content/download/index.html) covers the GUI install for non-terminal users. All historical builds, changelogs, and signed checksums are on [GitHub Releases](https://github.com/strata-space/strata/releases).