Cybersecurity-Projects/PROJECTS/beginner/caesar-cipher/README.md

 ██████╗ █████╗ ███████╗███████╗ █████╗ ██████╗
██╔════╝██╔══██╗██╔════╝██╔════╝██╔══██╗██╔══██╗
██║     ███████║█████╗  ███████╗███████║██████╔╝
██║     ██╔══██║██╔══╝  ╚════██║██╔══██║██╔══██╗
╚██████╗██║  ██║███████╗███████║██║  ██║██║  ██║
 ╚═════╝╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝

Caesar cipher encryption, decryption, and brute-force cracking CLI with frequency analysis.

This is a quick overview — security theory, architecture, and full walkthroughs are in the learn modules.

Screenshots & demo →

What It Does

• Encrypt text using Caesar cipher with a specified shift key
• Decrypt ciphertext back to plaintext with the original key
• Brute-force crack unknown ciphertext by testing all 26 shifts
• Frequency analysis ranking to identify the most likely plaintext
• Clean Rich terminal output with colored tables

Quick Start

uv tool install caesar-salad-cipher
caesar-cipher encrypt "HELLO WORLD" --key 3

[!TIP] This project uses just as a command runner. Type just to see all available commands.

Install: curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin

Commands

Command	Description
caesar-cipher encrypt	Encrypt plaintext using a specified shift key
caesar-cipher decrypt	Decrypt ciphertext back to plaintext with the original key
caesar-cipher crack	Brute-force all 26 shifts with frequency analysis ranking

Learn

This project includes step-by-step learning materials covering security theory, architecture, and implementation.

Module	Topic
00 - Overview	Prerequisites and quick start
01 - Concepts	Security theory and real-world breaches
02 - Architecture	System design and data flow
03 - Implementation	Code walkthrough
04 - Challenges	Extension ideas and exercises

License

AGPL 3.0