XC: A lightweight, Zsh-native command vault manager

Rakosn1cek · Yesterday 08:59:19

Feature Complete [v0.9.0] XC command vault manager has officially reached its feature-complete milestone. All planned functionality, including template engines, global search, and GPG security, is now implemented and stable.

I built this tool to solve the common issue where shell history becomes a dumping ground for thousands of unorganised, plain text commands. I was tired of keeping sticky notes or relying on grep to find that specific command I ran three days ago.
XC is a lightweight and native Zsh vault manager that keeps your frequently used snippets organised, searchable, and secure.

The logic is built around the idea that a tool should work with your shell, not against it. It integrates directly into Zsh using ZLE. You do not need to install complex dependencies.
If you have Zsh, fzf, and GnuPG installed, you are ready to go.

One of the core features is the template engine. Instead of saving a brittle one-liner, you can wrap variables in curly brackets, such as {{target_ip}}.
When you call that command, XC pauses the execution flow, prompts you for the input, and injects the completed string into your terminal buffer. This prevents the common error of running a command with stale arguments.

For vaults containing sensitive environment variables or API keys, XC supports symmetric encryption via GnuPG. You can lock or unlock vaults to keep credentials secure at rest.
Management is proactive. If you run a complex command, you can type [xc] to capture the last entry, add a description, and move it into your active vault.
If you are looking for older commands, [xc select] opens an fzf interface that lets you search your shell history and save entries directly into your library.

I have kept the project distro-agnostic because I wanted it to work on any stable Linux environment. For Arch users, it is available via the AUR:

yay -S xc-manager-git

I have reached the original development goals for this project, so it is now stable and ready for use. If you are interested in cleaning up your shell workflow, you can find the source and documentation on the repository below.

GitHub Repo

Feedback is very welcome.
Contributions to make it work in other shells (bash, fish) are also very welcome.

Sorry, I tried to put image here, but I cannot figure out how to do it. You can find an image and short video in the GitHub Repo.

Rakosn1cek · Yesterday 10:35:20

I managed to get the image work. Here is the screenshot of XC git-pro community vault. There is many more community vaults in the repo available to download. Each one of them has about 50 commands in them.
Just check the repos community-vaults.

XC git-pro community vault

Arch Linux

#1 Yesterday 08:59:19

XC: A lightweight, Zsh-native command vault manager

#2 Yesterday 10:35:20

Re: XC: A lightweight, Zsh-native command vault manager

Board footer