# emacs-vc-jj

> Emacs user interface to the Jujutsu version control system

**Wikidata**: [Q134006973](https://www.wikidata.org/wiki/Q134006973)  
**Source**: https://4ort.xyz/entity/emacs-vc-jj

## Summary  
**emacs‑vc‑jj** is a free‑software Emacs Lisp package that provides a GNU Emacs user interface (a VC backend) for the **Jujutsu** version‑control system. First released on 15 March 2025, it is distributed through GNU ELPA and is maintained as part of the GNU Project.

## Key Facts  
- **Inception:** 15 March 2025 (initial release v0.0.1).  
- **Latest stable version:** 0.5, released 21 December 2025.  
- **Platform:** GNU Emacs (runs on any OS supported by Emacs).  
- **Programming language:** Emacs Lisp.  
- **License:** Q27016754 (free‑software license).  
- **Part of:** GNU Project; distributed by GNU ELPA since 18 April 2025.  
- **Repository:** Primary source at <https://codeberg.org/emacs-jj-vc/vc-jj.el>.  
- **Use case:** Provides Emacs’s built‑in VC (Version Control) interface for the Jujutsu VCS.  
- **Classification:** GNU Emacs user interface, GNU ELPA package, and free software.

## FAQs  
### Q: What does emacs‑vc‑jj do?  
**A:** It adds a VC backend to GNU Emacs, letting users interact with the Jujutsu version‑control system directly from the editor’s standard version‑control commands.

### Q: Which version of Jujutsu does emacs‑vc‑jj support?  
**A:** It is designed to work with the Jujutsu VCS as a whole; the package’s “use” property explicitly links it to Jujutsu.

### Q: How can I install emacs‑vc‑jj?  
**A:** Install it from GNU ELPA (package name **vc‑jj**) or clone the source from the Codeberg repository and load the `vc-jj.el` file in your Emacs configuration.

### Q: Is emacs‑vc‑jj free software?  
**A:** Yes. It is released under a free‑software license (Q27016754) and is classified as free software since its inception.

### Q: What is the current stable release?  
**A:** Version **0.5**, marked as the preferred stable release, was published on 21 December 2025.

## Why It Matters  
emacs‑vc‑jj bridges the gap between the modern, lightweight Jujutsu version‑control system and the long‑standing Emacs editing environment. By exposing Jujutsu through Emacs’s native VC interface, developers can manage repositories, view diffs, and perform commits without leaving their editor, preserving workflow continuity. Its inclusion in GNU ELPA ensures easy distribution and updates for the broader Emacs community, reinforcing the GNU Project’s commitment to free, interoperable tools. As Jujutsu gains adoption for its speed and simplicity, emacs‑vc‑jj positions Emacs users to leverage these advantages seamlessly, fostering a more integrated development experience across platforms.

## Notable For  
- **First VC backend for Jujutsu** in GNU Emacs, enabling native Emacs commands for the system.  
- **Rapid release cadence:** six versions (0.0.1 → 0.5) released within the first year, with stable releases every few months.  
- **Distribution via GNU ELPA**, guaranteeing easy installation and automatic updates for Emacs users.  
- **Free‑software status** under a recognized open‑source license, aligning with the GNU Project’s philosophy.  
- **Written entirely in Emacs Lisp**, making it highly extensible for Emacs power‑users.

## Body  

### Overview  
- emacs‑vc‑jj is a GNU Emacs package that implements a VC (Version Control) backend for the Jujutsu VCS.  
- It allows standard Emacs VC commands (`C-x v d`, `C-x v v`, etc.) to operate on Jujutsu repositories.  

### Development History  
| Release | Date | Notes |
|---------|------|-------|
| 0.0.1 | 15 Mar 2025 | Initial version (tag `v0.0.1`). |
| 0.1 | 15 Mar 2025 | Unstable iteration, commit `c75b27e…`. |
| 0.2 | 18 Apr 2025 | First stable release, packaged in GNU ELPA. |
| 0.3 | 15 Jun 2025 | Stable, ELPA tarball `vc-jj-0.3.tar.lz`. |
| 0.4 | 03 Sep 2025 | Stable, ELPA tarball `vc-jj-0.4.tar.lz`. |
| 0.5 | 21 Dec 2025 | Preferred stable version, latest ELPA entry. |

### Distribution & Packaging  
- **GNU ELPA**: Listed under package ID `vc-jj` since 18 Apr 2025.  
- **Nixpkgs**: Available as `emacsPackages.vc-jj`.  
- **Source repositories**: Primary development hosted on Codeberg (`https://codeberg.org/emacs-jj-vc/vc-jj.el`). Mirrors exist in the GNU Savannah Emacs ELPA archive.  

### Technical Details  
- **Programming language**: Emacs Lisp, the native extension language for GNU Emacs.  
- **Operating system compatibility**: Works on any OS supported by Emacs (Linux, macOS, Windows, etc.).  
- **License**: Identified by Wikidata item Q27016754, confirming free‑software status.  
- **Copyright holder**: Q48413 (the GNU Project).  

### Usage  
1. Install via `M-x package-install RET vc-jj RET` or add the Codeberg source to `load-path`.  
2. Enable the backend by adding `(require 'vc-jj)` to your Emacs init file.  
3. Use standard VC commands to interact with Jujutsu repositories.  

### Relationship to Other Entities  
- **Free software**: Classified as free software, sharing the same classification as the GNU Project and Emacs itself.  
- **Jujutsu**: The backend directly interfaces with Jujutsu, a version‑control system introduced in 2019.  
- **GNU Project**: emacs‑vc‑jj is a component of the GNU Project, reflecting its commitment to free, interoperable software.  

---  

*All information above is drawn exclusively from the provided source material.*

## References

1. [Source](https://elpa.gnu.org/packages/vc-jj.html)
2. [Source](https://codeberg.org/emacs-jj-vc/vc-jj.el/src/tag/v0.0.1)
3. [Source](https://codeberg.org/emacs-jj-vc/vc-jj.el/src/commit/c75b27e49c869b98a69ee10520915f6f93721fdc)
4. [[GNU ELPA] Vc-Jj version 0.2. 2025](https://lists.gnu.org/archive/html/gnu-emacs-sources/2025-04/msg00046.html)
5. [[GNU ELPA] Vc-Jj version 0.3. 2025](https://lists.gnu.org/archive/html/gnu-emacs-sources/2025-06/msg00045.html)
6. [[GNU ELPA] Vc-Jj version 0.4. 2025](https://lists.gnu.org/archive/html/gnu-emacs-sources/2025-09/msg00011.html)
7. [[GNU ELPA] Vc-Jj version 0.5. 2025](https://lists.gnu.org/archive/html/gnu-emacs-sources/2025-12/msg00039.html)
8. [New GNU ELPA package: vc-jj - VC backend for the Jujutsu version control. 2025](https://lists.gnu.org/archive/html/info-gnu-emacs/2025-04/msg00004.html)