jscheid / tandem-emacs

Emacs Plugin for Tandem

Tandem on Emacs

This repository contains code for the Emacs plugin for Tandem. For more details on Tandem, visit their website, or their mono-repository containing all other source code..

Status

So far this is just an incomplete hack, don't use this for anything serious yet.

Installation

This is not yet hosted on MELPA.

For now, clone this repository, then build the CLRT client as follows:

(cd tandem/crdt/ && yarn && yarn build)

Then load file tandem.el

Usage

Joining an Existing Session

M-x tandem-join-session

You will be prompted for the session ID.

Note that you can enter any text as long as it contains a UUID.

Hosting a Session

M-x tandem-host-session

This hosts a session for the current buffer.

The session ID will be shown in the minibuffer and copied to the kill ring.

Getting the ID for an Active Session

M-x tandem-show-session

This shows the session ID and copies it to the kill ring.

Killing a Session

M-x tandem-kill-session

This kills the session for the current buffer.

Viewing Agent Logs

M-x tandem-view-agent-log

Switches to the buffer containing the agent log.

tandem-emacs's Issues

How to use for simple testing?

I have started a session (I think) and see this in the log:

2020-08-30 17:14 INFO     Tandem UDPGateway is listening on ('', 55808).
2020-08-30 17:14 INFO     Tandem Agent has started.

But, as far as I can tell, I'm not able to join the session from another Emacs process running locally. Could you please add some more detailed instructions on how to use the system?

I'll note that Tandem is mentioned on https://www.emacswiki.org/emacs/CollaborativeEditing but Tandem-Emacs is not mentioned. Given the state of other solutions mentioned there, it seems to me that Tandem-Emacs may be the most promising!