Operation reference

Clear all locally stored auth sessions on this device.

No arguments.

Resolve user identities from locally cached JWT tokens.

Authenticate against a remote via browser-based OAuth flow. Returns user identity on success.

Authenticate against a remote using a bearer token, without a browser; returns the signed-in user.

Sign out of a server, clearing its stored session.

Resolve the currently authenticated user's ID and display name.

No arguments.

Archives a branch locally and on the remote, preventing further commits.

Create a new branch, optionally under a category and with an explicit branch id.

Show metadata for a branch — name, category, parent, creator, timestamps, and archive state.

List the latest revision history for a branch (newest first).

List all branches in the repository, optionally including archived branches.

Merge a named branch into the current branch.

Abort an in-progress branch merge, discarding its staged merge state.

Merge the current branch into a specified target branch with a commit message.

Mark conflicted files as resolved during an in-progress merge.

Resolve merge conflicts by accepting the local (mine) version for the specified paths.

Resolve conflicts on the given paths by taking the incoming (theirs) version.

Restart conflict resolution for the given paths in an in-progress branch merge.

Begin merging another branch into the current branch, optionally committing the result.

Mark files as unresolved during a merge, reverting previous conflict resolutions.

Read the metadata value stored on a branch under a given key.

Apply write protection to a branch, preventing direct commits.

Reset the local LATEST pointer of a branch to a specific revision.

Switch the working tree to a different branch.

Remove write protection from a branch, re-allowing direct commits.

Add file dependencies to the current repository with optional tags.

List file dependencies or dependents at a given revision.

Remove file dependencies (or specific tags) from the current repository.

Compute unified diff between two revisions.

Mark one or more paths as dirty (locally modified) so they are picked up by the next commit.

Stage a file copy without touching the filesystem. Creates a DirtyCopy node.

Mark a file as moved in the staging area.

Dump the binary content of a file by path or address.

Compute the BLAKE3 content hash and size of one or more files.

Show metadata for files — size, hash, flags, and staging status.

List all metadata key/value pairs for a file at a given revision.

Permanently remove a file's content at a specific address from the store. This is irreversible.

Reset one or more files to the state they were in at the last merged revision on a given branch.

Stage one or more paths for the next commit.

Remove one or more paths from the staged changeset.

Write a file from the repository to a destination path on the filesystem.

Mount a source repository as a layer inside the current repository at a target path.

Add a link to a remote repository at the specified path.

Remove a link from the repository at the specified path.

Acquire exclusive locks on one or more files for the current user.

Acquire exclusive file locks on behalf of another user (admin operation).

List file locks on a branch, optionally filtered by owner or path.

Release exclusive file locks for the specified paths.

Check the lock status of one or more files — shows owner and lock time.

Ask the holder of a locked file to check it in. They get a tray notification and an inbox entry with Release / Dismiss.

Clone a remote repository to a local directory.

Read a configuration value from the repository config.

Create a new local repository.

Create a new repository with explicit creator and timestamp metadata.

Delete a repository by URL.

Dump the repository tree structure at a given revision and path.

Flush pending repository data to persistent storage.

No arguments.

Run garbage collection on the repository to clean up unreferenced data.

No arguments.

Retrieve metadata about a repository (name, URL, default branch, creator).

List all repository instances (working copies) in the shared store.

No arguments.

Remove stale repository instances (working copies whose filesystem paths no longer exist) from the shared store.

No arguments.

List all repositories available at a remote URL.

Clear user-defined metadata keys from the repository (empty list clears all).

Read metadata entries from the repository (empty key returns all).

Set metadata key-value pairs on the repository.

Push local commits on the current branch to the remote.

No arguments.

Recover an unreachable local working tree — preserves the current tree and checks out a fresh local copy. Destructive: confirm before running.

Release the repository and free associated resources.

No arguments.

Update the stored repository path to match the current working directory.

No arguments.

Show working-tree status — branch, revision, changes, ahead/behind.

No arguments.

Query the immutable store for a fragment by address.

Sync the current repository with its remote, pulling and applying the latest changes.

No arguments.

Show local working-tree health — current/remote revision, pending merge, divergence, staged paths, conflicts.

No arguments.

Verify the integrity of a specific fragment by hash; optionally heal corruption.

Verify repository integrity; optionally heal detected inconsistencies. Returns fragment-level verification events and a typed summary.

Who-did-what-when rollup over the revision history — powers the premium Reporting & Insights add-on.

Amend the most recent revision's commit message.

Restart resolution for specified paths during an in-progress cherry-pick conflict.

Commit the staged changes with a message.

Commit staged changes with attached metadata key-value pairs.

Show file-level differences between two revisions.

Find revisions by metadata key/value or revision number, searching local and remote stores.

Find revisions by metadata key/value or revision number (local only).

Show revision history for the current branch or a specified revision.

Show metadata and file changes for a revision.

List the most recent revisions on the current branch, newest first.

Clear all metadata from the current revision.

No arguments.

Revert the working directory to a specified revision by applying the inverse of its changes.

Abort an in-progress revert operation and restore the working directory.

No arguments.

Revert the working directory to a specified revision by applying the inverse of its changes.

Mark conflicted paths as resolved during an in-progress revert.

Resolve revert conflicts on the given paths by keeping the local (mine) version.

Sync the working tree to a target revision, optionally resetting and pulling dependencies.

Restart the active hosted server from its private backend launch recipe. Requires the generation reported by Host Server: Status.

Launch a real Lore server (loreserver) over a local store on 127.0.0.1. Returns the lore:// URL to give to clients.

Show whether a hosted Lore server is running, with its pid, port, and lore:// URL.

No arguments.

Stop the hosted Lore server (loreserver) started from the GUI.

No arguments.

Scan the local network for lore servers (mDNS) and list any found, with the lore:// URL to connect. Open-core; the manual server URL always works too.

No arguments.

Start the Lore service process for the current repository.

Stop the Lore service process for the current repository (or all repositories).

Create a shared store on disk that repositories can use as a common content cache.

List the configured shared stores — their URLs, paths, existence, and auto-use setting.

No arguments.

Enable or disable automatic use of the configured default shared store for repositories.

Release an open storage handle, draining in-flight ops and flushing pending writes.

Copy a fragment from one partition to another in the same store, preserving its content hash.

Flush pending writes through an open storage handle, fsyncing disk-backed stores.

Read a content-addressed buffer from the open store using a session key returned by a prior Storage: Put.

Fetch a fragment's metadata (flags, payload size, content size) by partition and address — no bytes transferred.

Conditionally update a mutable key when its current value matches expected (empty expected matches an absent key). Returns previous value and whether the swap applied. Remote-capable.

List mutable key-value pairs of a given type on the local store. Remote targeting is rejected (local-only). Zero partition lists every accessible partition.

Read a mutable key's value (hash) from an open store. Absent keys return AddressNotFound on the item. Optional remote routing uses the handle's remote session.

Write a mutable key-value pair (hashes) on an open store. Empty or all-zero value removes the key. Optional remote routing uses the handle's remote session.

Open a content-addressed store (local path, remote URL, or in-memory) and return its handle.

Write a content-addressed buffer to an open store by key. The key lets you retrieve or obliterate the data later.

Read a file from disk and store its contents in an open store, returning the content address.

Push a locally-stored fragment to the remote attached to an open store (handle must have a remote configured).