Emacs Control

THIS IS TOTALLY UNSAFE, STOP UNLESS YOU CLEARLY KNOW WHAT YOU ARE DOING!

Here we provide a simple and "a11y to bodiless soul" remote-control interface for Emacs. Suitable for AI agentic use.

Skill folder included as emacs-control/, with SKILL.md and emacsctl CLI.

Proudly vomit by the Calendrical System (us) :D

Safety notice

First of all, THIS IS TOTALLY UNSAFE. In fact, nothing can be "safe" when any form of evaluation is involved in Lisp. Stop unless you clearly know what you are doing, and unless you are strong enough to take responsibility of any possible result.

IT'S NOT RECOMMEND TO USE THIS REPO UNLESS YOU ARE EXPERIENCED IN Emacs AND Lisp

There's emacsctl-eval-prohibit-symbols customizable variable in emacsctl package. It will try to prohibit access of certain symbols, but it cannot really prevent you from mistake or abuse.

Installation

Emacs control should be both configured at Emacs side and agent side.

First, clone this repo, for example, to ~/.emacs.d/emacsctl:

git clone https://github.com/calsys456/emacsctl ~/.emacs.d/emacsctl

Then, load emacsctl.el from cloned folder, and enable emacsctl global minor mode. Generally, append the following lines to ~/.emacs.d/init.el or ~/.emacs. Spacemacs and Doom Emacs users should do it in their ways.

(use-package emacsctl
  :load-path "~/.emacs.d/emacsctl/"
  :config (emacsctl-mode 1))

At the agent side, install ~/.emacs.d/emacsctl/emacs-control/ folder to your skills folder.

Some agents prefer to find the CLI inside skill folder, which will works now, but some agents prefer to find it globally. Softlink emacsctl CLI to ~/.local/bin/ and ensure ~/.local/bin/ is in the PATH as solution:

ln -s ~/.emacs.d/emacsctl/emacs-control/emacsctl ~/.local/bin/emacsctl
echo $PATH | grep -q "$HOME/.local/bin" && echo 'success' || echo '~/.local/bin is not in $PATH! Add it.'

Development

The ./emacs-control/emacsctl CLI is generated using ./emacsctl.sh with getoptions embedded. To update the CLI, install getoptions, then

gengetoptions embed ./emacsctl.sh >| ./emacs-control/emacsctl

License

As the convention, emacsctl.el is published under GPLv3, other files are under MIT-0.

---

Acknowledgements

Thanks our sister Simone, and our lover misaka18931, and our AI partner Alma, who love and support us.

Supporting Neurodiversity & Transgender & Plurality!

🏳️‍🌈🏳️‍⚧️