xc-manager

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 50 Open GitHub ↗

A lightweight, Zsh-native vault for command execution with GPG encryption, interactive templates, and fzf integration.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## XC - command vault manager
**Version: 0.9.0**

[![Awesome Zsh Plugins](https://img.shields.io/badge/Awesome-Zsh%20Plugins-brightgreen)](https://github.com/unixorn/awesome-zsh-plugins)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Shell](https://img.shields.io/badge/shell-zsh-brightgreen.svg)](https://github.com/Rakosn1cek/xc-manager)
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/Rakosn1cek/xc-manager)](https://github.com/Rakosn1cek/xc-manager/releases)
![GitHub stars](https://img.shields.io/github/stars/Rakosn1cek/xc-manager?style=flat&color=gold)
[![Discord](https://img.shields.io/badge/Discord-Join%20the%20Hub-7289da?style=flat&logo=discord&logoColor=white)](https://discord.gg/GFk45RdS)

![XC-Manager TUI](https://github.com/Rakosn1cek/xc-manager/blob/main/XC-GitPro-vault-screenshot.png)

**XC in Action:**
<p align="center">
  <video src="https://github.com/user-attachments/assets/d67640fb-4e9e-4d36-b7a1-d588a24ab9a6" width="700" controls muted autoplay loop>
    Your browser does not support the video tag.
  </video>
</p>

XC is a lightweight, Zsh-native vault manager for command execution. It’s for anyone who live in the CLI and need a fast, searchable, and now secure way to manage their most important one-liners. No bloat, no complex dependencies. Just your commands, vaulted.

**Status:** 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.

**Recent Fixes & Updates** [0.9.0]
- **Vault Security**: Integrated GPG symmetric encryption. Use `xc lock` and `xc unlock` to protect sensitive commands, API keys, and environment variables.
- **Pre-flight Safety**: Added extension-aware logic to prevent accidental operations on encrypted vaults.
- **Raw Input Capture**: Added `xc add --raw` to handle complex commands. This bypasses shell evaluation, allowing you to save `curl`, `jq`, and nested subshells exactly as they are written without the shell stripping quotes or expanding variables.
- **Community Vaults**: Expanded the curated collection via `xc sync`. All community vaults now contain at least 50 useful commands and strings.

---

**Installation:**

Arch Linux (AUR)
`yay -S xc-manager-git`

**Manual Installation**
Clone the repository:
`git clone https://github.com/Rakosn1cek/xc-manager.git ~/.zsh-plugins/xc-manager`

**Add to ~/.zshrc:**
```zsh
source ~/.zsh-plugins/xc-manager/xc.plugin.zsh
[[ -f ~/.zsh_aliases ]] && source ~/.zsh_aliases
```

**All distros including MacOS**
```zsh
HISTFILE=~/.zsh_history
HISTSIZE=10000
SAVEHIST=10000
setopt appendhistory
```
**Optional UI Customisation**
```zsh
zstyle ':xc:*' separator "->"
zstyle ':xc:*' fzf_colors "fg:7,hl:4,fg+:15,hl+:12,info:2,prompt:5,pointer:12"
```

**Initialise (First time only):**
`xc init`

---

**Dependencies:**

To ensure all features work as intended, make sure the following are installed:

- **Zsh**: The core shell environment (version 5.8+ recommended).
- **fzf**: Powering the fuzzy search and interactive selection.
- **GnuPG**: Required for the `lock` and `unlock` encryption features.
- **curl**: Necessary for synchronising community vaults via `xc sync`.

**Arch Linux:**
```zsh
pacman -S zsh fzf gnupg curl
```
---

**Community Sync:**
Pull any curated, Arch Wiki-verified "Problem-Solution" vaults directly from the repository.

---

**Features:**
- Template Engine: Support for {{placeholders}} with interactive prompts.
- Alias Export: Convert any vaulted command into a permanent Zsh alias with `Alt+E`.
- Global Search: Toggle between local vault and global search using Ctrl+A and `Ctrl+R`.
- Proactive Saving: Run `xc` to save the command you just executed.
- FZF Integration: Fuzzy search with live previews.
- Distro Agnostic: Works on Arch, Fedora, Debian, and macOS.
- Vault Security: Symmetric GPG encryption to protect sensitive commands and API keys.
- Save commands with {{variables}} to create templates. XC prompts for input during execution.
- Global Swap: Using the same name (e.g. cp {{file}} {{file}}.bak) prompts once and updates all instances.
- Individual Control: Use unique names (e.g. mv {{old}} {{new}}) to prompt for each value separately.

---

**Usage Guide:**

- Launch TUI: Press Ctrl+G anywhere in your terminal.
- Switch Vault: Use `xc use <name>` to change your active context (e.g. xc use work).
- List Vaults: Run `xc list` to see your available vault files.
- Delete Entry: Press `Alt+D` inside the TUI.
- Global Search: Press `Ctrl+A` to search across all vaults inside the TUI.
- Create Aliases: Select command to export -> press `Alt+E` -> Enter alias name -> Save
- Sync Vaults: Run `xc sync` to browse the community index.
- Save Command: Run `xc` after successful command -> Enter descriptions -> Save
- Select Command from History: Run `xc select` -> choose command to save -> Enter descriptions -> Save
- Capture Raw Text: Run `xc add --raw` -> paste complex command -> Press Enter -> then `Ctrl+D` to enter descriptions -> Save
- Check Version: Run `xc -v`

**Security & Encryption**
- For vaults containing sensitive environment variables, API keys, or internal IPs, XC now supports symmetric encryption via GPG.
- Lock a vault: `xc lock` encrypts the active vault and removes the plain text file.
- Unlock a vault: `xc unlock` restores the vault to plain text for editing/searching.
- Protection: XC will automatically block search and add operations if a vault is locked, preventing binary data corruption or accidental plain text writes.

> *Note 1:
Aliases are saved by default to ~/.zsh_aliases. If you prefer to save them directly into your main config file, add this to your .zshrc:
`export XC_ALIAS_TARGET="$HOME/.zshrc"`
Vaults are saved by default in `$HOME/.local/share/xc`.
The active state (which vault you are currently using) is tracked in `$HOME/.cache/xc_active_vault`*

> *Note 2:
**Optional Integrations**
Alias Browser (als)
If you want an easy way to browse and run your newly created aliases using `fzf`, Check out my show-aliases.sh script.
It searches both your .zshrc and .zsh_aliases to give you a unified, interactive menu.
View Script: on GitHub [Show-Aliases Script](https://github.com/Rakosn1cek/dotfiles-rk1/tree/main/shell-common/custom-scripts/Show-Aliases)*

---

**Long-term research**

[ ] Cross-Shell Research (Bash/Fish wrappers)

> **Note:** I have reached the original goals for this project and will not be personally pursuing cross-shell support. If you are interested in implementing Bash or Fish wrappers, contributions and PRs are welcome.

**Support & Feedback**
- Bug Reports: If something isn't working, please open an [Issue](https://github.com/Rakosn1cek/XC-Manager/issues).
- Feature Ideas: To discuss the roadmap or suggest a polish, head over to the[Discussions](https://github.com/Rakosn1cek/XC-Manager/discussions) tab.
- Community Snippets: Have a complex one-liner you've vaulted? Share it in the "Show and Tell" discussion.

If XC-Manager has made your CLI life easier, consider giving it a star on GitHub! It helps other developers find the tool.

[⭐ Star XC on GitHub](https://github.com/Rakosn1cek/XC-Manager)

Tired of hostile Linux forums? Join the Discord server. A focused, friendly space to discuss XC with the developer and other users. No gatekeeping, just Linux tools.

[![Discord](https://img.shields.io/badge/Discord-Join%20the%20Hub-7289da?style=flat&logo=discord&logoColor=white)](https://discord.gg/GFk45RdS)

**License**
Distributed under the MIT License. See LICENSE for more information.

## Status: Stable / Maintenance Mode
XC has officially reached its design goals and is now considered feature-complete. The core logic, including the template engine, global search, and GPG symmetric encryption is stable, reliable, and thoroughly tested.
As there are no outstanding bugs or required feature expansions, active development has transitioned into a dedicated maintenance and discovery phase.
The focus moving forward is strictly on ensuring long-term compatibility with future Zsh updates, maintaining repository security, and curating community vault submissions.

**What this means for users**:

The tool is safe, dependable, and production-ready. No breaking changes or disruptive feature creep will alter your established workflows.

**Bug Reports & Security**:

If a future shell update breaks compatibility or an issue is discovered, please open a ticket on the GitHub Issues tab. These will be addressed promptly.

**Contributions**: While the core codebase is frozen, contributions to the community vaults via Discussions are highly encouraged. Please share your useful command templates and one-liners in the GitHub Discussions area or over on the Discord server.

xc-manager

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README