A client for the Morphcloud Navigator API, for browser apps (and Node). It signs members in to a workspace app with OAuth PKCE, returns the Navigator envelope for every call, names the workspace → table → row → cell paths, runs actions, and keeps a live socket open with reconnects.
npm install @morphcloud/client
import { createMorphcloud } from '@morphcloud/client'
const mc = createMorphcloud(connect) // your workspace app's connect data
await mc.auth.handleRedirect()
if (!mc.auth.isSignedIn()) await mc.auth.signIn()
const { data } = await mc.workspace.table('tasks').rows({ size: 50 })
The full guide — for people and for coding agents such as Lovable — is AGENTS.md.
This repository is a mirror
The source lives in Morphcloud's backend repository, next to the API it calls, so an API change
and its client change are made together. Every change to main there is copied here, and this
repository publishes the package to npm.
Issues are welcome here. Pull requests cannot be merged here directly; we copy an accepted change into the backend repository, and it comes back through the mirror.
Development
npm install
npm run typecheck && npm test && npm run build
For maintainers, in the backend repository: when a change alters the envelope
(NavigatorTraversalResponse, NavigatorNodeControl), the row page (ApiRowPageResponse), the
socket frame (NavigatorSocketMessage) or the workspace app connect data (ApiWorkspaceAppConnect),
change client/src/ and client/AGENTS.md in the same commit. To publish, raise version in
package.json; the mirror publishes a version that npm does not have yet.
