1
0
Fork
You've already forked xc.el
0
Integrate the xc task runner with Emacs
  • Emacs Lisp 100%
Ryan Prior 97d53502ac Moves treemacs functionality into its own sub-package 
* xc-treemacs.el: new subpackage contains all treemacs logic.
* README.org: updates init instructions
* xc.el: removes treemacs logic.
2026年07月14日 00:42:37 +00:00
COPYING v1 release 2025年10月29日 18:45:23 +00:00
README.org Moves treemacs functionality into its own sub-package 2026年07月14日 00:42:37 +00:00
screenshot-v1.png Adds description & screenshot 2025年10月29日 22:50:34 +00:00
xc-treemacs.el Moves treemacs functionality into its own sub-package 2026年07月14日 00:42:37 +00:00
xc.el Moves treemacs functionality into its own sub-package 2026年07月14日 00:42:37 +00:00

About

xc.el provides an Emacs interface for xc.

Action shot

/ryanprior/xc.el/media/branch/main/screenshot-v1.png
Emacs screenshot showing a buffer editing README.md with a Treemacs sidebar displaying available XC tasks in a tree.

To use

  • M-x xc RET task-name RET
    Runs the given task. The set of available tasks is offered for completion.
  • In Treemacs, a project with xc tasks in its root README will show an [XC TASKS] list in its tree. To run a task, double-click it, or move point to your desired task and press RET. See the action shot above for an example, and "Configuration" below for instructions to enable the Treemacs integration.

Installation instructions

You can install this package directly from Codeberg like so:

 (use-package xc
 :vc (:url "https://codeberg.org/ryanprior/xc.el.git" :branch "main"))

If you use Spacemacs, you can add this data to your dotspacemacs-additional-packages:

 (xc :location (recipe :fetcher codeberg
 :repo "ryanprior/xc.el"))

If you would like to help me get this into GNU Elpa, feel free to bug me. (Otherwise I will probably get around to it eventually.)

Configuration 

 ;; Recommended: bind to keyboard
 (bind-key "C-c x" #'xc)
 ;; If you use Treemacs, initialize the integration:
 (with-eval-after-load 'treemacs
 (require 'xc-treemacs))

Customization options

xc-executable

By default, the package will use whatever xc is found on your PATH. If that's not what you want, customize xc-executable to point to the executable you prefer to use. An absolute path is recommended, but a relative path is also permitted, which might be handy i.e. as a directory-local variable.

xc-type

When invoked, xc will use whichever type of README it finds, searching the current directory and then in parents: either README.md or README.org. In a directory that has both files, it will prefer Markdown. If you want to limit xc to use only one type, customize xc-type as either "org" or "md".