OpenParable
Skip to content
← Back to skills

Loro

Development
loro

Loro is an Agent Skill for development published in the loro-dev/loro repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Practical guide for helping app developers evaluate, adopt, and use Loro for local-first collaboration. Use when Codex needs to answer questions or write examples for `loro-crdt`, `loro`, `loro-prosemirror`, `loro-codemirror`, `loro-mirror`, language bindings such as Swift/Python/C#/Go/React Native, or Loro-powered apps about: (1) Deciding whether Loro fits a product, (2) Getting started in JavaScript/TypeScript, Rust, or another supported binding, (3) Choosing CRDT containers and document structure, (4) Designing sync, persistence, snapshots, versioning, undo, presence, or time travel, (5) Integrating rich-text editors and stable selections, (6) Mirroring app state with React, or (7) Understanding performance and tradeoffs.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/loro-dev/loro/blob/HEAD/skills/loro/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/loro, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Loro

Use this skill to help users build applications with Loro. Start from the user's product goal, then choose the narrowest chapter that answers it. Load a second chapter only when the task crosses domains.

Select A Chapter

Route Common Tasks

  • “I am new to Loro / should I use it / show me a first example”
    • Start with fit-and-architecture.md
  • “Which language package or binding should I use?”
    • Start with fit-and-architecture.md
  • “Build a collaborative document model / choose data types / persist history”
    • Start with containers-and-encoding.md
    • Add sync-versioning-and-events.md if version/history behavior matters
  • “Sync devices, store data, use snapshots, time travel, undo, or presence”
    • Start with sync-versioning-and-events.md
  • “Integrate ProseMirror, Tiptap, CodeMirror, or custom rich text”
    • Start with richtext-and-editors.md
    • Add sync-versioning-and-events.md if undo/version/event behavior matters
  • “Model app state with loro-mirror or loro-mirror-react”
    • Start with mirror-and-react.md
    • Add containers-and-encoding.md if schema semantics depend on container choice
  • “Explain performance, large documents, loading, update size, or tradeoffs”
    • Start with performance-and-tradeoffs.md
  • “Decide whether Loro is the right tool”
    • Start with fit-and-architecture.md
    • Add performance-and-tradeoffs.md if workload scale matters

Execute The Task

  1. Classify the task before reading everything.
  2. Load one primary chapter.
  3. Load at most one secondary chapter for cross-domain work.
  4. Keep solutions grounded in Loro semantics:
    • choose data types by merge behavior,
    • distinguish state version from history version,
    • keep ephemeral state out of persisted CRDT data,
    • use stable cursors for collaborative selections,
    • design sync around updates and snapshots rather than a central locking protocol.

Keep Guardrails

  • Do not assume CRDTs are the right fit for hard invariants, exclusivity, or authorization-at-write-time problems.
  • Do not model editable text as plain strings when user intent requires merged edits.
  • Do not reuse peer IDs across concurrent sessions.
  • Do not confuse detached documents with detached containers.
  • Do not persist cursor presence, hover state, or connection state inside the main document; use ephemeral state.