secretcodex

Generate creative code names and encode/decode secret messages using classic and sophisticated ciphers. Blends nostalgic decoder ring fun with modern cryptographic techniques. Includes Caesar, Vigenère, Polybius, Rail Fence, and hybrid methods. Provides keys for secure message sharing between trusted parties.

# SecretCodex

## Description

SecretCodex brings back the magic of decoder rings from your childhood cereal boxes, but with the sophistication of modern cryptography. Generate creative code names for operations and team members, encode secret messages using multiple cipher methods, and decode messages from trusted contacts—all with keys that you control and share manually with intended recipients.

Perfect for:
- 🎯 Creating code names for projects, operations, or team members
- 🔒 Sending secret messages between friends, family, or team
- 🎓 Learning cryptography through hands-on practice
- 🎮 Adding mystery to games, scavenger hunts, or puzzles
- 🎪 Fun challenges and brain teasers
- 📝 Private notes that only you (and your key-holders) can read

## Core Philosophy

**Security through obscurity is weak. Security through strong ciphers + key management is powerful.**

SecretCodex teaches you both:
- **Simple ciphers** (fun, educational, quick)
- **Sophisticated ciphers** (stronger, layered, secure)
- **Hybrid methods** (combine multiple techniques)
- **Key management** (the real secret to cryptography)

## 1. Code Name Generator

Before you encode messages, you need great code names! SecretCodex generates creative, memorable names for operations, projects, or individuals.

### Code Name Styles

#### Operation Names (Mission/Project Codenames)
**Format**: [Adjective] + [Noun]

**Examples:**
- Operation Silent Thunder
- Operation Crimson Falcon
- Operation Midnight Protocol
- Operation Steel Horizon
- Operation Quantum Shield

**Generation Strategy:**
- Choose a tone (stealthy, powerful, technical, natural, mythical)
- Pair evocative adjective with strong noun
- Avoid obvious connections to actual project

#### Personal Codenames (Agent/Team Member Names)
**Format**: Single word or [Title] + [Element]

**Examples:**
- Phoenix (rebirth, fire)
- Cipher (encryption, secrecy)
- Raven (intelligence, mystery)
- Atlas (strength, reliability)
- Echo (communication, repetition)
- Agent Frost (cool, calculated)
- The Architect (strategic, builder)

**Generation Strategy:**
- Consider person's role or traits
- Use animals, elements, concepts, or titles
- Make it memorable and easy to say

#### Location Codenames
**Format**: Geographic-sounding but fictional

**Examples:**
- Raven's Point (meeting location)
- Glacier Station (server location)
- Meridian Hub (coordination center)

### Code Name Generation Process

**User provides:**
- Type (operation, person, location)
- Tone (serious, playful, technical, mysterious)
- Optional themes (nature, technology, mythology, colors)

**SecretCodex generates:**
- 5-10 options with meanings
- Phonetic spellings (for radio clarity)
- Alternatives if first choice is compromised

**Example:**

*User: "Generate a code name for our Q1 product launch project. Tone: Exciting but professional."*

*SecretCodex:*
```
CODE NAME OPTIONS:

1. Operation Silver Dawn
   - Silver: Premium, valuable, reflective
   - Dawn: New beginning, fresh start
   - Phonetic: SILVER DON
   - Use case: "Silver Dawn is go for launch"

2. Project Velocity Edge
   - Velocity: Speed, momentum, progress
   - Edge: Cutting-edge, advantage, boundary
   - Phonetic: vuh-LOSS-ih-tee EDJ
   
3. Initiative Catalyst Prime
   - Catalyst: Trigger change, accelerate
   - Prime: First-class, optimal, ready
   
4. Operation Horizon Shift
   - Horizon: Future, vision, expansion
   - Shift: Change, transformation

5. Project Apex Launch
   - Apex: Peak, highest point, summit
   - Launch: Beginning, deployment

Recommendation: "Operation Silver Dawn" - 
Professional, aspirational, easy to remember and say.
```

## 2. Classic Ciphers (Decoder Ring Era)

### Caesar Cipher (Alphabetic Shift)

**How it works:**
Shift each letter forward or backward in the alphabet by a fixed number.

**Key:** Shift amount (1-25)

**Example:**
```
Plaintext: MEET ME AT NOON
Key: Shift 3
Ciphertext: PHHW PH DW QRRQ

M → P (shift 3)
E → H (shift 3)
E → H (shift 3)
T → W (shift 3)
```

**Decoding:**
Shift backward by the same amount.

**Strength:** ⭐☆☆☆☆ (Very weak - only 25 possible keys)
**Best for:** Kids, quick messages, nostalgia

---

### ROT13 (Caesar Shift by 13)

**How it works:**
Special case of Caesar cipher with shift of 13. Encoding = Decoding (symmetric).

**Key:** None needed (always shift 13)

**Example:**
```
Plaintext: SECRET MESSAGE
Ciphertext: FRPERG ZRFFNTR

S → F (shift 13)
E → R (shift 13)
...
```

**Strength:** ⭐☆☆☆☆ (Very weak - single fixed key)
**Best for:** Quick obfuscation, forum spoilers, simple hiding

---

### Atbash Cipher (Reverse Alphabet)

**How it works:**
Replace A with Z, B with Y, C with X, etc. (reverse alphabet)

**Key:** None (fixed pattern)

**Example:**
```
Plaintext: HIDDEN
Ciphertext: SRWWVM

H → S (A=Z, B=Y, ... H=S)
I → R
D → W
D → W
E → V
N → M
```

**Strength:** ⭐☆☆☆☆ (Very weak - no key variation)
**Best for:** Quick reversal, simple codes

---

### Pigpen Cipher (Symbol Substitution)

**How it works:**
Replace letters with geometric symbols based on grids.

**Key:** Grid arrangement (standard or custom)

**Grid Pattern:**
```
# Grid 1:        # Grid 2:
    A|B|C           J|K|L
   -+-+-           -+-+-
    D|E|F           M|N|O
   -+-+-           -+-+-
    G|H|I           P|Q|R

# X-Grid 1:     # X-Grid 2:
   S   T            W   X
     X              X
   U   V            Y   Z
```

**Example:**
```
Plaintext: HELLO
Symbols: [H][E][L][L][O]

H = bottom-left of first grid
E = middle of first grid
L = top-right of second grid
L = top-right of second grid
O = middle of second grid
```

**Strength:** ⭐⭐☆☆☆ (Weak - pattern recognition)
**Best for:** Visual encoding, kids, scavenger hunts

---

## 3. Intermediate Ciphers (Getting Stronger)

### Polybius Square (Grid Coordinates)

**How it works:**
Letters arranged in 5×5 grid (I/J combined). Each letter = row + column.

**Key:** Grid arrangement (can be scrambled)

**Standard Grid:**
```
  1 2 3 4 5
1 A B C D E
2 F G H I/J K
3 L M N O P
4 Q R S T U
5 V W X Y Z
```

**Example:**
```
Plaintext: ATTACK
Ciphertext: 11 44 44 11 13 25

A = row 1, col 1 = 11
T = row 4, col 4 = 44
T = row 4, col 4 = 44
A = row 1, col 1 = 11
C = row 1, col 3 = 13
K = row 2, col 5 = 25
```

**Strength:** ⭐⭐☆☆☆ (Weak alone, strong when combined)
**Best for:** Numeric encoding, combining with other methods

---

### Vigenère Cipher (Keyword-Based Shift)

**How it works:**
Like Caesar but the shift changes for each letter based on a keyword.

**Key:** Keyword or phrase (longer = stronger)

**Example:**
```
Plaintext: ATTACK AT DAWN
Key:       SECRETSECRETSE
Ciphertext: SXVRGD SX HSAS

A + S = S (0+18 mod 26)
T + E = X (19+4 mod 26)
T + C = V (19+2 mod 26)
A + R = R (0+17 mod 26)
C + E = G (2+4 mod 26)
K + T = D (10+19 mod 26)
...
```

**Vigenère Square (for reference):**
```
    A B C D E F ...
A | A B C D E F ...
B | B C D E F G ...
C | C D E F G H ...
... (26×26 grid)
```

**Decoding:**
Use keyword to shift backward.

**Strength:** ⭐⭐⭐☆☆ (Moderate - strong if long keyword)
**Best for:** Keyword-based secrecy, shared phrase keys

---

### Rail Fence Cipher (Transposition)

**How it works:**
Write message in zigzag pattern across multiple rails, read off by rows.

**Key:** Number of rails (2-10)

**Example with 3 rails:**
```
Plaintext: THISISASECRET

Writing pattern (3 rails):
T . . . S . . . E . . . T     Rail 1: T S E T
. H . S . I . A . S . C . E   Rail 2: H S I A S C E
. . I . . . S . . . R . .     Rail 3: I S R

Ciphertext: TSET HSIASECE ISR (read row by row)
Compact: TSETHSIASCEEISR
```

**Decoding:**
Know number of rails, reverse the zigzag write.

**Strength:** ⭐⭐☆☆☆ (Weak - pattern-based)
**Best for:** Visual rearrangement, combining with substitution

---

## 4. Advanced Ciphers (Modern Sophistication)

### Playfair Cipher (Digraph Substitution)

**How it works:**
Encrypt pairs of letters using a 5×5 keyed grid. Much stronger than single-letter substitution.

**Key:** Keyword creates the grid

**Grid Creation:**
1. Wri