oct-daemon

oct-daemon is a headless host daemon for Open Collaboration Tools. It creates an OCT room, exposes a local workspace folder, and lets normal VS Code or OpenVSCode clients join through the OCT extension.

It is built for the quiet plumbing around collaborative editing: share a folder when you need a room, or mirror a room into a real local directory when an agent needs to edit files with ordinary filesystem access.

Create a room

Host a folder

Host workspace

pnpx @skxv/oct-daemon --workspace /path/to/workspace

This command starts oct-daemon against a folder path, creates a room on the OCT server, and prints the room code and join URI. Guests can connect to that room and read or write files through the protocol.

Use it when a local workspace is the source of truth and you want to make that folder available to collaborators, tools, or remote coding sessions.

Sync for agents

Mirror a room into a directory

Sync room

pnpx @skxv/oct-daemon@latest sync --room your-room-key --workspace /path/to/workspace

The sync command joins an existing OCT room, downloads the remote workspace into a local folder, and keeps both sides moving together as files are created, edited, or deleted.

That makes the room usable for agentic editing: an agent can work in a normal local directory while the room host and collaborators stay connected through OCT.