Send commands to Emacs from programs running in term.el.

Programs running in term.el can print a special escape sequence to
run commands in Emacs -- this is how directory tracking works.
However, by default the commands are hard-coded, and you can't add
new ones.

This package lets you add new commands.  It uses a different escape
sequence to avoid interfering with the built-in commands, but the
principle is the same.  When a program prints a command, it won't
show up on the screen, but will instead be interpreted by Emacs.

This is a library, and doesn't make any user-visible changes.  For
an example of something that uses it, see the 'term-alert' package
(https://github.com/calliecameron/term-alert).


Usage

To register a command:

    (add-to-list
     'term-cmd-commands-alist
     '("command" . some-callback-function))

where "command" is the name of the command, and
some-callback-function is the function you want to be called when
the command is run.  The function should take two arguments -- the
first is the command name itself, and the second is the command's
argument.

To send a command, use the emacs-term-cmd script:

    emacs-term-cmd command arg

If called outside Emacs, this does nothing (i.e. it won't mess
things up).

Because the commands are based on terminal output, they work just
as well through nested shells, multiple SSH sessions, and tmux.


Installation

Install the term-cmd package from MELPA.

To use inside tmux, add 'set -g allow-passthrough all' to
~/.tmux.conf.

The emacs-term-cmd command will always be on the PATH of any shell
launched from Emacs.  However, for full functionality you should
also add ~/.emacs.d/term-cmd (or wherever your user-emacs-directory
is) to the PATH in your environment or shell's startup files
(e.g. ~/.profile, ~/.bashrc, ~/.zshrc, etc.), on any machine you
often SSH into; this will allow shells inside tmux or on other
machines to send commands back to Emacs on your local machine.