CLI Command Reference

Log in to Strata via browser-based OAuth.

Opens your default browser to complete authentication. Detects SSO from your email domain and routes to your IdP if configured.

On a remote, SSH, or headless host (no local browser), prints a URL and prompts you to paste back the code shown in the browser. Pass --no-browser to force that flow.

Examples:

strata login
strata login --email you@company.com
strata login --no-browser

Log out of Strata and remove the stored OAuth token.

Clears the token from the OS keychain. Does not affect tokens passed via --token or the STRATA_TOKEN env var.

Example:

strata logout

Show the current state: logged-in user, API URL, active mounts, and linked folders.

Pass a folder to show that folder's live-sync detail instead.

Examples:

strata status
strata status ~/notes

List accessible Spaces.

Without any flags, lists all Spaces you have access to.

Examples:

strata spaces                              # all your Spaces
strata spaces --scope personal              # all personal Spaces
strata spaces --scope org --scope-id tenant_01JAB...     # Spaces in one org

Link a local folder to a Space so it stays in live, two-way sync as ordinary Markdown files. Remote edits appear locally within seconds and local saves merge back as CRDT deltas — no clobber window, no conflict copies. There is no virtual filesystem, so it behaves identically on macOS and Linux.

By default this installs a supervised background service (launchd on macOS, systemd on Linux) that runs the sync and restarts it on failure and at login. Pass --foreground to run it in this terminal instead.

Examples:

strata link ~/notes --space <space_id>               # always-on background service
strata link ~/notes --space <space_id> --foreground  # this session only

Remove a link with strata unlink <space_id>.

List linked folders (active supervised sync daemons) and their Spaces

Stop and remove the supervised background sync for ONE folder. Local files are left in place. Other folders syncing the same Space are untouched.

To stop syncing without uninstalling, use strata sync pause.

Pass --purge to force-flush a wedged install: it removes the local sync cache (.strata/) and health sidecar even when the service registration is missing or orphaned, so a fresh strata link re-downloads clean state from the Space. Use it when a crashed daemon left an install that a plain strata unlink refuses to find. Markdown files are kept either way.

Examples:

strata unlink <folder>
strata unlink <folder> --purge

One-time pull or push of Space documents to/from a local directory as Markdown files. Each invocation copies the current state and exits — no background process, no live updates. For a live, two-way folder kept in sync, use strata link.

By default, push is flat: newly created documents land at the Space root, regardless of local subdirectories (existing documents are updated in place and keep their current folder). Pass --folders to recreate the directory tree as Strata folders and file new documents into them. (Pull always materializes server folders as local subdirectories, so a pull/edit/push round-trip without --folders flattens the result.)

Examples:

strata sync pull <space_id> ./notes          # download Space as .md files
strata sync push <space_id> ./notes          # upload changed files (flat)
strata sync push <space_id> ./notes --folders # upload, preserving folders

Mount a Space as a live filesystem (FUSE on Linux, FSKit on macOS).

Documents appear as Markdown files; edits sync to the API as you make them and remote changes appear locally. Runs in the background until you strata unmount. For a one-time snapshot in either direction, use strata sync instead.

Defaults to read-write. Pass --readonly to mount read-only.

Examples:

strata mount <space_id> ~/strata
strata mount <space_id> ~/strata --readonly
strata mount <space_id> ~/strata --foreground

Unmount a previously-mounted Space.

With no argument, unmounts the only active mount. Otherwise accepts either a Space ID or the mountpoint path.

Examples:

strata unmount                 (when exactly one Space is mounted)
strata unmount <space_id>
strata unmount ~/strata

Manage the Strata background agent.

One per-user agent supervises every linked folder (and keeps the login session fresh); link commands install and start it automatically. This group is the explicit lifecycle surface.

Examples:

strata agent status
strata agent restart
strata agent run --replace      (attached to this terminal, for debugging)

Use a Strata Space as a coding agent's long-term memory.

Bind a repository to a Space, then let the agent's lifecycle hooks (the strata-memory plugin for Claude Code / Codex) drive the loop: hybrid-search recall on every prompt, plus a stop-time nudge when session work changed files but no relied-upon memory document was updated.

Human verbs:

strata memory init                 # pick a Space interactively
strata memory bind <space_id>      # bind this repo (add --scope project to commit)
strata memory status               # show binding + effective config
strata memory unbind               # remove the binding

Hook verbs (preflight, recall, check, observe) read the host's hook JSON from stdin, print hook-protocol JSON, and always exit 0.

Direct API access for scripts, automation, and LLM agents.

Three layers:

- Typed subcommands (documents, spaces) wrap common operations.
- Discovery (list, describe, openapi) walks the embedded OpenAPI
  spec so an agent with no prior knowledge can find any endpoint.
- `api raw` then executes any endpoint by method + path.

Discover-then-call workflow:

strata api list                            # all tags
strata api list Documents                  # operations in a tag
strata api describe update_document        # full schema for one op
strata api raw PATCH /api/v1/documents/doc_01J... --body @edit.json

Typed shortcuts:

strata api documents list
strata api documents create --title "Notes" --content "# Hello"

Print a shell completion script to stdout.

Install per your shell's convention. Examples:

strata completions fish > ~/.config/fish/completions/strata.fish
strata completions zsh  > ~/.zsh/completions/_strata
strata completions bash > /etc/bash_completion.d/strata