Releases: zephyrus-development/zephyrus-cli
Zephyrus CLI v1.4.0 - Website revamp
⚙️ Changelog
- Add support for uploading entire directorys at a time via iteration.
- Add support for downloading exitre directorys at a time.
- Add a transfer-vault feature that allows for all the files in one vault to be propogated into another
- Add icons to the website
- Command to allow for the user to change there password called reset-password
- Add web support for the following features.
- Login
- File viewing
- File download
💭 Community Feedback
We'd love to hear from you!
-
Questions? Open a discussion
-
Found a bug? Open an issue
-
Want to contribute? Check out CONTRIBUTING.md
-
Security concern? Email Auchrio@proton.me
📝 Release Notes
Version: 1.4.0
Release Date: February 4, 2026
Status: Stable
Zephyrus CLI v1.3.1 - Custom sharing URL
⚙️ Changelog
- Implemented the new, shorter sharing url of
zep.ftp.sh
💭 Community Feedback
We'd love to hear from you!
-
Questions? Open a discussion
-
Found a bug? Open an issue
-
Want to contribute? Check out CONTRIBUTING.md
-
Security concern? Email Auchrio@proton.me
📝 Release Notes
Version: 1.3.1
Release Date: February 4, 2026
Status: Stable
Zephyrus CLI v1.3.0 - 24hrs of development release
🎉 This release signifies one day of developement on this project 🎉
Where will this project be in 7 days? Star it and find out 👀
⚙️ Changelog
- Make the setup command clone the readme from this repository on execution of
zep setup - Add a settings/config file in the vault which allows the persistent customisation of the following runtime attributes.
- The commit attributation of database updates (currently attributes all commits to @Auchrio)
- The length of both the normal file hash (normally 16 characters) and the share hash (normally 6 characters)
- Alter the share system so the share hash file is just a pointer to the main file, rather than a copy
- Add detailed progress bars to all commands to make execution times seem shorter
- Add a general info command with the following functionality, if run without arguments, print the current user information and general vault statistics, if run with argument file, display data such as file name, file hash, and file size on remote.
- Add shared file management through file name rather than just file hash, use a search to determine what files match the query to allow shortnames.
- Implement a
localls(aliaslls) which can only be used inside of the REPL shell which passes through the ls command from the main terminal. - Implement a
localdir(aliasldir) command which can only be used inside of the REPL shell which passes through the dir command from the main terminal.
💭 Community Feedback
We'd love to hear from you!
-
Questions? Open a discussion
-
Found a bug? Open an issue
-
Want to contribute? Check out CONTRIBUTING.md
-
Security concern? Email Auchrio@proton.me
📝 Release Notes
Version: 1.3.0
Release Date: February 4, 2026
Status: Stable
Zephyrus CLI v1.2.1 - Bug fixes
⚙️ Changelog
- Added a direct download link to the output of both the initial sharing of a file and a
shared infocall
📝 Release Notes
Version: 1.2.1
Release Date: February 4, 2026
Status: Stable
Zephyrus CLI v1.2.0 - Sharing is Caring
⚙️ Changelog
- Added a read (cat) command which allows users to read files from the vault without needing to download it locally first
- Added the option to type username as part of the shell command rather than being prompted for it.
- Overhauled the share feature to enable for more efficient sharing
- Created a web portal to download the shared files meaning only the sharer needs to use the cli
💭 Community Feedback
We'd love to hear from you!
-
Questions? Open a discussion
-
Found a bug? Open an issue
-
Want to contribute? Check out CONTRIBUTING.md
-
Security concern? Email Auchrio@proton.me
📝 Release Notes
Version: 1.2.0
Release Date: February 4, 2026
Status: Stable
Zephyrus CLI v1.1.0 - Ease of Access
⚙️ Changelog
- Fixed issue with REPL shell exiting if a file that does not exist on remote becomes the target of a share or download.
- Made REPL shell only launch with the shell, or sh command rather than when the
zepcommand is run without arguments. - Made the upload and download commands assume identical file names if no custom name is provided.
- Increased the accessibility of the setup command so it is easier for first time users to understand without needing to reference the github readme.
- Improved help command to be more informative to first time users.
💭 Community Feedback
We'd love to hear from you!
-
Questions? Open a discussion
-
Found a bug? Open an issue
-
Want to contribute? Check out CONTRIBUTING.md
-
Security concern? Email Auchrio@proton.me
📝 Release Notes
Version: 1.1.0
Release Date: February 4, 2026
Status: Stable
Zephyrus CLI v1.0.0 - Initial Release 🎉
What is Zephyrus CLI?
Zephyrus CLI transforms your GitHub repository into a private, encrypted file vault. Store sensitive documents, backups, and confidential files with industry-standard AES-256-GCM encryption—all from your command line. No subscriptions. No proprietary infrastructure. No secrets to trust anyone with.
✨ Key Features in v1.0.0
🔐 End-to-End Encryption
- AES-256-GCM encryption with authenticated encryption
- PBKDF2-SHA256 key derivation (100,000 iterations) protects your vault password
- All encryption happens on your machine before uploading
- GitHub servers never see plaintext data
🔑 Per-File Encryption Keys
- Each file gets a unique, randomly-generated 32-byte encryption key
- Share individual files without exposing your entire vault
- Revoke access by re-uploading the file with a new key
- No need to share your vault password with anyone
💼 Complete File Management
- Upload files with automatic folder creation
- Download files with transparent decryption
- Delete files or entire folders recursively
- List vault contents with hierarchical organization
- Search vault with case-insensitive substring matching
🔄 Multiple Operation Modes
- Interactive Shell (REPL) — Multiple commands in one authenticated session
- Command-line Mode — Single commands without entering shell
- Stateless Mode (
-uflag) — Authenticate per-command without persistent sessions
📤 Secure File Sharing
- Generate shareable tokens with
sharecommand - Format:
username:storage_id:decryption_key - Recipients only get access to that specific file
- No need for third-party file sharing services
☁️ GitHub-Backed Storage
- Leverage GitHub's free tier for encrypted storage
- Full git history of all operations
- Atomic commits ensure consistency
- Shallow clones optimize bandwidth usage
💻 Cross-Platform
- Windows: Native executable (
.exe) - macOS: Compile from source
- Linux: Compile from source
- Same feature set across all platforms
🛡️ Security First
- No telemetry or tracking
- Source code fully auditable
- Standard cryptographic primitives (no proprietary algorithms)
- Zero-knowledge architecture (we can't access your data)
📋 Complete Command Reference
| Command | Description |
|---|---|
setup |
Initialize vault with GitHub SSH key |
connect |
Create persistent session (cache index locally) |
upload |
Encrypt and upload file to vault |
download |
Download and decrypt file from vault |
delete |
Remove file or folder from vault |
ls |
List vault contents |
search |
Search for files by name or path |
share |
Generate shareable access token |
disconnect |
Remove local session cache |
purge |
Completely wipe vault (irreversible) |
💭 Community Feedback
We'd love to hear from you!
- Questions? Open a discussion
- Found a bug? Open an issue
- Want to contribute? Check out CONTRIBUTING.md
- Security concern? Email Auchrio@proton.me
📝 Release Notes
Version: 1.0.0
Release Date: February 4, 2026
Status: Stable
This is the first production release of Zephyrus CLI. All core features are stable and ready for use. Please test thoroughly and report any issues.