spillwavesolutions/okf-remote
v0.3.0MIT
Replication of an OKF bundle across machines, plus read-only MCP access. No write verbs.
Changelog
0.3.0 — 2026-09-03
- Replication is push, triggered by a directory watcher (
scripts/remote_watch.py). Debounce default 2s plus batching. remote_rsync.py pushis the documented default. Destination from$OKF_REPLICA_DEST. Pull is retained as a backstop. Still no--deleteby default.- S3 writer path: local watcher puts objects. Consumer-side daemon pulling to local disk is unchanged (
docs/S3.md). - Network MCP:
serve --bind host:portis an OAuth 2.1 / OIDC resource server. stdio remains the default and unauthenticated. Binding withoutOKF_MCP_ISSUERis a startup error (docs/AUTH.md). - Auth gates access; it does not add verbs. Watcher death is visible on
replica_status.
0.2.0 — 2026-09-03
queryverb: cursor-paginated filesystem walk. Not offset.reverse_pointersreadspointer.linkfiles and returns the inverse name on inbound edges.agentic_searchremains a skill, not a verb. Model is configured per deployment (OKF_AGENTIC_SEARCH_MODEL).- Documented S3 path: consumer-side daemon pulling objects to local disk (
docs/S3.md).
0.1.1 — 2026-09-03
walk_chronologicalwalks the replica filesystem and returns metadata only.get_noderefuses path escape. Artifacts (telemetry/summary/saliency) are omitted from the walk.
0.1.0 — 2026-09-03
- Initial scaffold. Spec: okf-plugin#74.