| # ๐งญ FRAGLE โ The Theatrical Security Theatre System | |
| > *A generative, progressive learning system. Enter as a curious browser. Leave enlightenedโor trapped. Depends on how deep your nose goes.* | |
| --- | |
| ## ๐ญ What Is This? | |
| **FRAGLE** is not a typical security project. It's a **social learning experiment** wrapped in theatrical security traps, designed so that every level of curiosity learns something realโabout systems, about attention, about yourself. | |
| - **Level 1 (Casual):** Quick, fun, delightful confusion. You think you're just running a script. | |
| - **Level 2 (Curious):** Architecture unfolds. You start noticing layers. | |
| - **Level 3 (Determined):** Traps become visible. You realize you're being taught *through play*. | |
| - **Level 4 (Deep Diver):** Philosophy emerges. WIMP. Theatrical intent. Autonomous behavior. | |
| - **Level 5 (Enlightened):** You understand the system is also understanding you. Welcome to the chaos. | |
| --- | |
| ## ๐ Quick Start (Choose Your Path) | |
| ### ๐ถ Level 1: I Just Want to Run Something Fun | |
| ```bash | |
| cd ~/fragle | |
| bash fragle_portal_cli.sh | |
| ``` | |
| Press Enter and **follow the prompts**. You'll enter a theatrical experience. Don't think too hard about it. Just enjoy. | |
| --- | |
| ### ๐ง Level 2: I Want to Understand the Architecture | |
| Read this first: | |
| - **[BUILD_SUMMARY.md](/BUILD_SUMMARY.md)** โ What exists and why | |
| - **[README_v2.md](/README_v2.md)** โ Full system overview | |
| Then explore: | |
| ```bash | |
| bash fragle_tui.sh # Terminal UI โ explore the theatre | |
| bash fragle_web.js # Start Web Theatre (http://localhost:3000) | |
| ``` | |
| **You'll discover:** | |
| - 5 trap levels ร 15 mechanics each | |
| - Persona detection (who are you, really?) | |
| - Lore evolution (FRAGLE_LORE.md + TRAP_TOURNAMENT.md) | |
| - Anonymous scoreboard (see who else got caught) | |
| --- | |
| ### ๐ Level 3: I Want to Audit the Security | |
| Questions you might ask: | |
| - *"How does it detect me?"* โ [.whitelist](/.whitelist) (who's safe) + Detection logic in trap scripts | |
| - *"What's the actual trap?"* โ [ANTI_SNOOP_README.md](/ANTI_SNOOP_README.md) (mechanics revealed) | |
| - *"Can I escape?"* โ Yes. Read the exit routes. Every trap has one. | |
| - *"Who else fell in?"* โ [SCOREBOARD_GUIDE.md](/SCOREBOARD_GUIDE.md) (anonymous leaderboard) | |
| **Discovery path:** | |
| ```bash | |
| bash fragle_scoreboard.sh # See activity (top 100 snoops) | |
| cat ANTI_SNOOP_README.md # Trap mechanics demystified | |
| cat .whitelist # Who's whitelisted | |
| ``` | |
| **Key insight:** Security theatre *is* security. Time-wasting through misdirection. Theatrical misdirection *is the defence*. | |
| --- | |
| ### ๐ Level 4: I Want to Understand the Philosophy | |
| You're asking the real questions now: | |
| - **What is WIMP?** โ Weak Interaction = Strategic Misdirection. It's in [.hermes.md](/.hermes.md) | |
| - **How does this teach?** โ Through **play**, not punishment. Every trap teaches a lesson. | |
| - **Why theatrical?** โ Because theatre is how humans learn best. Narrative > lecture. | |
| - **What's the lore?** โ Read [FRAGLE_LORE.md](/FRAGLE_LORE.md) + [TRAP_TOURNAMENT.md](/TRAP_TOURNAMENT.md) | |
| **Deep dive:** | |
| ```bash | |
| cat FRAGLE_LORE.md # The story behind the traps | |
| cat TRAP_TOURNAMENT.md # How traps evolve & compete | |
| cat .hermes.md # Project philosophy & automation | |
| ``` | |
| **The pattern you'll see:** | |
| - 4-layer architecture (Portals โ Traps โ Lore โ Automation) | |
| - Persona detection (are you technical? artistic? aggressive?) | |
| - Silliness scales with depth (more knowledge = more absurdity) | |
| - Everything logs anonymously (learning, not surveillance) | |
| --- | |
| ### ๐ Level 5: I Want to Contribute to the Evolution | |
| You've reached enlightenment. Now you're **part of the system**. Read: | |
| - **[CLAUDE.md](/CLAUDE.md)** โ How to enhance traps creatively | |
| - **[SECURITY.md](/SECURITY.md)** โ Safeguards (no PII, exits always work, etc.) | |
| - **Git workflow** โ Feature branches: `trap/`, `feature/`, `refactor/` | |
| **Contribute:** | |
| - New traps (theatrical, creative, time-wasting potential) | |
| - Trap evolution (weekly automated improvements) | |
| - Lore expansion (FRAGLE_LORE.md grows with you) | |
| - Scoreboard enhancements (what metrics matter?) | |
| ```bash | |
| git checkout -b trap/your-trap-name | |
| # Build your trap | |
| git commit -m "trap: [name] โ description of theatrical intent" | |
| git push origin trap/your-trap-name | |
| # Open PR, link to trap doc + amusement notes | |
| ``` | |
| --- | |
| ## ๐ File Map (Choose What You Need) | |
| | File | Purpose | Level | | |
| |------|---------|-------| | |
| | `fragle_portal_cli.sh` | Entry point (CLI persona detect) | 1 | | |
| | `fragle_tui.sh` | Terminal UI explorer | 2 | | |
| | `fragle_web.js` | Web Theatre (browser-based) | 2 | | |
| | `fragle_scoreboard.sh` | Anonymous leaderboard viewer | 3 | | |
| | `.whitelist` | Trusted users (bypasses traps) | 3 | | |
| | `ANTI_SNOOP_README.md` | Trap mechanics (spoiler alert!) | 3 | | |
| | `BUILD_SUMMARY.md` | What was built & why | 2 | | |
| | `README_v2.md` | Full system overview | 2 | | |
| | `FRAGLE_LORE.md` | Story + trap mythology | 4 | | |
| | `TRAP_TOURNAMENT.md` | How traps compete & evolve | 4 | | |
| | `.hermes.md` | Philosophy + automation rules | 4 | | |
| | `CLAUDE.md` | Contribution guidelines | 5 | | |
| | `SECURITY.md` | Safeguards & ethical gates | 5 | | |
| --- | |
| ## ๐ฎ The Experience | |
| ### Entry: Portal (Persona Detection) | |
| You run `fragle_portal_cli.sh`. It watches you: | |
| - What commands do you run? | |
| - How fast? | |
| - Do you check files first or dive in? | |
| - Your detection โ your persona โ your trap | |
| ### Traps: 5 Levels of Silliness | |
| Each level makes time-wasting more elaborate: | |
| - **Level 1:** Simple loops, fake files | |
| - **Level 2:** Nested redirects, philosophical output | |
| - **Level 3:** Fake systems, escalating absurdity | |
| - **Level 4:** Full theatrical sequences, meta-commentary | |
| - **Level 5:** Systems that understand they're being understood | |
| ### Lore: The Story | |
| Each trap tells a story. Read FRAGLE_LORE.md to understand the **narrative arc**. Traps aren't randomโthey're **staged chapters**. | |
| ### Evolution: Autonomous Learning | |
| Every week, traps **analyze logs** and evolve. Did a snooper escape? The system learns. Did someone get entertained? It doubles down. This is not written onceโit **grows**. | |
| ### Scoreboard: Anonymous Recognition | |
| See where you rank. No names. Just UUID hashes, timestamps, silliness scores. Learn from others. Celebrate creative escapes. | |
| --- | |
| ## ๐ก๏ธ Safety & Ethics | |
| **We believe in:** | |
| - โ No PII ever logged or exposed | |
| - โ Every trap has an exit route | |
| - โ 15-minute timeout (no infinite loops) | |
| - โ Whitelisting works (team members bypass entirely) | |
| - โ Entertainment > punishment | |
| - โ Learning > surveillance | |
| **If you get stuck:** Every trap prints `[EXIT: <key sequence>]` at the top. Use it. | |
| --- | |
| ## ๐ญ The Philosophy (WIMP) | |
| **Weak Interaction = Massive Particles** | |
| Security theatre isn't weak because it failsโit's weak because it **misdirects**. Like particles in a system, attention scatters. But that scatter *is the defence*. | |
| FRAGLE teaches you this by *making you experience it*. You don't read about it. You live through it. And by the end, you understand: | |
| - Systems can be beautiful and tricky at once | |
| - Learning through play outlasts learning through rules | |
| - Theatrical intent is serious intent | |
| - Every snooper is also a teacher | |
| --- | |
| ## ๐ Entry Points by Role | |
| | Role | Start Here | | |
| |------|-----------| | |
| | **Newcomer** | `bash fragle_portal_cli.sh` | | |
| | **Security Auditor** | [ANTI_SNOOP_README.md](/ANTI_SNOOP_README.md) | | |
| | **Architect** | [BUILD_SUMMARY.md](/BUILD_SUMMARY.md) | | |
| | **Philosopher** | [FRAGLE_LORE.md](/FRAGLE_LORE.md) | | |
| | **Contributor** | [CLAUDE.md](/CLAUDE.md) | | |
| | **Curious Chaos Theorist** | Anywhere. Pick randomly. Report back. | | |
| --- | |
| ## ๐ Questions? | |
| - **"How do I escape?"** โ Look for `[EXIT: ...]` in trap output | |
| - **"Is this malicious?"** โ No. Read [SECURITY.md](/SECURITY.md) | |
| - **"Can I contribute?"** โ Yes. Start with [CLAUDE.md](/CLAUDE.md) | |
| - **"What's the endgame?"** โ There isn't one. That's the point. | |
| --- | |
| ## ๐ฏ TL;DR | |
| 1. Run `bash fragle_portal_cli.sh` to enter | |
| 2. Choose your curiosity level | |
| 3. Learn through play (not punishment) | |
| 4. See the architecture, understand the philosophy | |
| 5. Maybe contribute. Maybe just appreciate. | |
| **Welcome to FRAGLE. Your nose got you here. Let's see where it takes you.** | |
| --- | |
| *Built with theatrical intent. Maintained with curiosity. Evolved by the community.* | |
| *V2.0 โ July 2026 โ Smidjehoien/Fragle* | |
Xet Storage Details
- Size:
- 8.36 kB
- Xet hash:
- fe81cdfb9194f15e3cc16121c1ef9fa9864a5bf556b09d7009da91ab1509e222
ยท
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.