oct-daemon

Host and sync OCT workspaces from the command line.

oct-daemon wraps Open Collaboration Tools in a CLI that can either host a local folder as a room or join a room and mirror it into a local directory. The same package handles both flows.

Host mode

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

Host mode creates a new OCT room, exposes the selected workspace, accepts joins, and serves filesystem operations for connected clients. The daemon prints a generated room ID and join URI when the room is ready.

Room IDs are generated by the OCT server. A caller-chosen room code is not supported in v1.

--workspace <path>

Folder to share. This is required for host mode.

--server <url>

OCT server URL. Defaults to https://api.open-collab.tools/.

--auth-token <token>

Reusable OCT login token.

--auth-token-file <path>

Token file. Defaults to <workspace>/.opencollabtools-daemon/auth-token.

--readonly

Reject write operations from guests.

--exclude <glob>

Repeatable exclude glob.

--name <name>

Workspace display name. Defaults to the folder basename.

-d, --detached

Run the daemon in the background.

Sync mode

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

Sync mode joins an existing room and keeps a local folder aligned with the remote workspace. It downloads the room contents first, then watches local filesystem changes and pushes creates, edits, and deletes back to the room host.

Incoming collaborator changes are written back into the same local folder, which makes the command useful when an agent needs normal file access while staying attached to a live OCT room.

sync --room <code>

Room code to join. This is required for sync mode.

sync --workspace <path>

Local folder to synchronize.

sync --server <url>

OCT server URL. Defaults to https://api.open-collab.tools/.

sync --auth-token <token>

Reusable OCT login token.

sync --auth-token-file <path>

Token file for the local sync client.

sync --exclude <glob>

Repeatable exclude glob.

Default excludes

oct-daemon ignores common private, generated, and metadata paths by default.

**/.env
.git/**
node_modules/**
.opencollabtools-daemon/**
.opencollabtools-sync/**