Architecture overview
Local-first research state, durable Git sync, shared Hub, and live paper collaboration

Researcher A

Human researcher working locally with an AI agent.

Researcher B

Another researcher with an independent local instance.

Researcher C
Project C
Cursor
Researcher D
Project D
DeepSeek
Researcher E
Project E
Open Code
Local ResearcherOS
Local web app for working with research state, agents, and experiments.
◫Web clientworkspace UI
⌘Local API serverproject services
✦Agent runtimeskills + tools
↔Paper collaborationYjs / proposals
✓Research toolsreview / paper / literature
Local ResearcherOS
Local web app for working with research state, agents, and experiments.
◫Web clientworkspace UI
⌘Local API serverproject services
✦Agent runtimeskills + tools
↔Paper collaborationYjs / proposals
✓Research toolsreview / paper / literature
Shared Research Project
Same project state as Researcher B, synchronized through one Git repository.

experiment code

  • source code
  • configs
  • training scripts
  • artifacts / outputs
  • normal Git branches

research state

  • hypothesis tree
  • kanban
  • reports & knowledge
  • skills / widgetsresearcher-owned
  • papers
Shared Research Project
Same project state as Researcher A, synchronized through one Git repository.

experiment code

  • source code
  • configs
  • training scripts
  • artifacts / outputs
  • normal Git branches

research state

  • hypothesis tree
  • kanban
  • reports & knowledge
  • skills / widgetsresearcher-owned
  • papers
ResearcherOS Hub
Discovery, reuse, and public project views.
◎Project catalogshared snapshots
✦Shared skillsbrowse / download
⌕Discovery & reuseprojects / practices
◉Read-only public viewvisibility rules

Fast collaboration for paper writing

live path

A low-latency session between local instances; Git remains the durable base.

CRDT / Yjsconvergent document state
WebRTC / relaycross-instance transport
Presence & commentshuman collaboration
Proposal reviewagent / external edits
Git remote
Persistent source of shared project state.
research stateResearch state / project history
code branchesExperiment implementation
push / pullversionedportable
durable sync / publication
real-time collaboration
Layout edit mode: drag cards by their headers. Click an arrow, then drag the purple handle to bend it. Drag arrow labels directly. Changes are saved locally; use Export HTML to download the edited layout.
Architecture rule: the Hub is not the source of truth. Researchers A and B work on local copies of the same project and synchronize them through one Git remote. The Hub exposes published project snapshots from this and other projects as read-only views; the live collaboration path accelerates paper editing without replacing Git history. local copies → one Git remote · other projects → read-only Hub