CLIコマンドリファレンス

One-time download of Space documents as .md files

One-time upload of changed .md files back to a Space

Pause background syncing without removing any link.

Pass a synced folder to pause just that link, or --all to pause every linked folder at once (each link keeps its own pause state, so resume --all restores exactly what was running before).

Pass --for to auto-resume after a preset window; the agent resumes on its own, even across restarts.

Examples:

strata sync pause ./notes
strata sync pause --all
strata sync pause --all --for 1h

Resume background syncing, or confirm a held bulk deletion.

For a paused folder (or --all for the global pause), resumes syncing. For a running folder whose mass-delete guard tripped — deleting many files at once would unlink a large fraction of the Space's documents — confirms the held deletions and lets sync continue. Unlinking removes documents from the Space only; they still exist and can be re-added.

Examples:

strata sync resume ./notes
strata sync resume --all

Follow one document live from the terminal.

Joins the document's collaboration session as a terminal reader (collaborators see you in the web editor), keeps a local copy, and prints one line per event. With --json, or when stdout is not a terminal, each line is one JSON object with an event field:

snapshot            documentVersion, walSeq, title, markdown, reason
(initial | edit | reconnect); at most one per second
presence            collaborators on the document at join time
collaboratorJoined  collaborator (entityId, displayName, clientKind)
collaboratorLeft    entityId, entityType, clientKind
comment             commentId, change (created | updated | deleted |
resolved | reopened), actor when known
suggestion          suggestionId, change (created | updated | accepted |
rejected | stale | withdrawn)
status              state (connected | reconnecting | goAway), reason, attempt
error               code (unauthorized | accessDenied | notFound |
controlSocketInUse | controlSocketUnavailable |
transport), message; exits 1

Every event carries documentId. The markdown in a snapshot is the same projection read_document returns. The watch reconnects on its own with backoff and prints a fresh snapshot only when the content changed while it was away.

--control PATH serves HTTP over a Unix socket (mode 0600), or over a named pipe on Windows (PATH is \\.\pipe\<name>), so another program can steer the watch:

POST /cursor  {"section": "Heading > Subheading"}  show your cursor at
that section in the web editor (204); null clears it
POST /leave   leave the document and exit 0 (202)

Other paths answer 404, other methods 405. Ctrl-C and SIGTERM leave cleanly; so does the end of stdin when it is a pipe and no --control is given. With --control, or with stdin from /dev/null, leave through the control channel or a signal.

Examples:

strata doc watch doc_01JAB...
strata doc watch doc_01JAB... --json --control /tmp/strata-watch.sock
strata doc watch doc_01JAB... --json --control \\.\pipe\strata-watch   (Windows)
curl --unix-socket /tmp/strata-watch.sock -X POST -H 'Content-Type: application/json' \
  -d '{"section":"Architecture > Data tiers"}' http://watch/cursor

Show agent liveness, version, and supervision state

Install (or repair) the agent and its login supervision unit

Upgrade an already-installed agent to this CLI's version (no-op when none is installed)

Restart the agent (the one-click repair)

Stop the agent and remove its supervision unit (links and credentials are kept)

Run the agent attached to this terminal (debugging)

List your workspaces, the selected one marked

Select the workspace later commands work in

Bind this repository to a Space as its agent memory

Interactively pick an accessible Space and bind it

Remove this repository's memory binding

Show the resolved binding and effective memory-loop config

SessionStart hook: verify auth + binding, seed the session ledger (stdin: hook JSON)

UserPromptSubmit hook: search the bound Space, inject candidates (stdin: hook JSON)

Stop hook: nudge once if memory was not reconciled (stdin: hook JSON)

PostToolUse hook: record memory documents the agent read (stdin: hook JSON)

Document operations

List documents

Get a document by ID

Get document content (markdown)

Create a new document

Code blocks tagged html render as live sandboxed previews (vetted libs: mermaid, d3, three, doom) — guide: <https://strata.space/documentation#interactive-html>

Edit a document (replace all content)

Code blocks tagged html render as live sandboxed previews (vetted libs: mermaid, d3, three, doom) — guide: <https://strata.space/documentation#interactive-html>

Move a document to a different folder, changing who can see it.

A document's audience is its folder: a personal folder is owner-only, a tier folder is visible to that tier's members.

Delete (trash) a document

Search documents

Folder operations (a document's audience is its folder)

List folders and their scopes (the audience a document gets in each)

Create a new folder

Space operations

List spaces

Get space info

List documents in a space

Add documents to a space

Search within a space

List API surface — tags, or operations within a tag.

strata api list — every tag with operation count strata api list <tag> — operations under that tag

Search operationIds, paths, and summaries for a keyword.

Case-insensitive substring match. Useful when you know the verb you want (e.g. "comment", "share", "upload") but not which tag it lives under.

Examples: strata api search comment strata api search "documents/{docId}" strata api search reaction

Show the full schema for one operation: parameters, request body, responses.

Accepts either an operationId or a "METHOD /path" pair.

Response schemas are inlined shallowly by default to keep output small; pass --full to deep-resolve them.

Examples:

strata api describe update_document
strata api describe "GET /api/v1/spaces"
strata api describe list_comments --full

Dump the embedded OpenAPI spec to stdout (for offline tooling)

Send a raw HTTP request to any API endpoint.

Use this when the typed subcommands don't cover the endpoint you need. Discover available endpoints first with:

strata api list                            # all tags
strata api list Documents                  # operations under a tag
strata api describe update_document        # full schema for one op
strata api describe "GET /api/v1/spaces"   # or by route

Body sources (--body accepts three forms, avoids shell-quoting pain):

--body '{"k":"v"}'   inline JSON string
--body @file.json     read from file (curl-style)
--body -              read from stdin (also @-)

Examples:

strata api raw GET /api/v1/spaces
strata api raw GET /api/v1/documents/doc_01J...
strata api raw POST /api/v1/spaces --body '{"name":"Notes"}'
strata api raw POST /api/v1/spaces --body @space.json
echo '{"name":"Notes"}' | strata api raw POST /api/v1/spaces --body -
strata api raw DELETE /api/v1/documents/doc_01J...

Output is the response body. JSON is pretty-printed; non-JSON is passed through. Non-2xx responses exit non-zero and print the error body.