# Chapose: High-Performance File Security Guardian (CLI)

**Chapose** is a professional-grade command-line tool powered by the **ChaCha20-Poly1305** AEAD algorithm. Designed for high performance, automation, and robust security, it is the specialized CLI component of the **ChaCrypt** ecosystem.

## Quick Install

Install the released binary to the default local path:

```sh
curl -fsSL https://raw.githubusercontent.com/huanguan1978/chacrypt/main/chapose/install.sh | sh -s -- --version 1.0.0
```

Then verify it with:

```sh
chapose --version
```

For package manager installation (macOS Homebrew / Windows winget), binary compatibility notes, source build instructions, and troubleshooting, see the full documentation in [./doc/en/README.md](./doc/en/README.md).

---

## 📖 Documentation & Guides

Detailed technical documentation and references are categorized below:

### 🎮 For Users (CLI Reference)
- [**Command-Line Usage Guide**](./doc/en/README.md#-core-functional-guide) - `keyfile`, `encrypt`, `decrypt` commands.
- [**Best Practices**](./doc/en/README.md#-best-practices-seamless-encryption) - Seamless "Zero-Touch" encryption setup.

### 💻 For Developers (SDK & Format)
- [**SDK Usage Guide (Dart)**](./doc/en/README.md#️-sdk-usage-guide-dart) - Integrate `.cha` encryption into your own apps.
- [**.cha File Format Specification**](./doc/en/README.md#-cha-file-format-definition) - Binary structure and algorithm details.

---

## 🌍 Language Versions

- [**English Documentation (Full)**](./doc/en/README.md)
- [**简体中文文档 (完整版)**](./doc/zh/README.md)

---

## 💖 Support the Project
If you find this tool helpful and would like to see it continue to improve and evolve, please consider showing your support.

*   ⭐ **Star the Repo**: This is a great encouragement. Your stars help more people discover this tool and gain more recognition in the community.
*   ☕ **Support the Developer (Global)**: Any contribution, however small, is a huge affirmation of my work. You can support via [GitHub Sponsors](https://github.com/sponsors/huanguan1978) or [Buy Me a Coffee](https://buymeacoffee.com/huanguan1978).
*   🐼 **Support via Ifdian (Mainland China)**: Users in China can also show support via [Ifdian](https://ifdian.net/a/huangaun1978).

*Thank you for your support, which is a vital boost that keeps me focused on the project's continuous iteration; because of you, more people can benefit from this tool much sooner.*