🖥️ AcuityOS: Cyber Agent

A premium, retro-futuristic virtual desktop hacking simulation game — playable entirely in your browser.

🎮 About

AcuityOS: Cyber Agent is an immersive, narrative-driven detective simulation where you play as a newly recruited cyber intelligence agent. You boot into a classified virtual operating system, receive mission briefings from your handler, and use a suite of hacking tools to unravel a dark conspiracy — "The Blackwood Anomaly".

The entire game runs as a single-page web application with zero external dependencies. No frameworks, no libraries, no CDN calls — just pure HTML, CSS, and JavaScript.

✨ Features

• 🖥️ Realistic Virtual Desktop — Draggable, resizable windows with a glassmorphic UI, CRT scanline overlay, and a macOS-style upper menu bar
• 📁 Mock File System — Browse classified folders, open documents, and discover hidden evidence
• 💻 Interactive Terminal — Type real commands (scan, decrypt, trace, analyze) to progress through the investigation
• 🗃️ Agent Database — Search and cross-reference suspect profiles, personnel files, and location data
• 🔬 System Analyzer — Drag-and-drop files for forensic analysis with visual scanning animations
• 🎵 Procedural Soundtrack — Real-time ambient suspense music generated using the Web Audio API (no audio files needed)
• 📖 Full Narrative Arc — A complete story with plot twists, moral choices, and multiple endings
• 🎨 Premium Design — Neon accents, glassmorphism, smooth animations, and retro-futuristic aesthetics

🚀 Getting Started

Play Locally

1. Clone the repo:

   git clone https://github.com/YOUR_USERNAME/acuity-os.git
   cd acuity-os

2. Open in browser:

   open index.html

   Or simply double-click index.html — no server required!

Play with a Local Server (Optional)

For the best experience with Web Audio:

# Using Python
python3 -m http.server 8080

# Using Node.js
npx serve .

Then visit http://localhost:8080

🎯 How to Play

1. Boot the OS — Watch the retro boot sequence initialize
2. Enter your codename — Choose your agent identity
3. Read your briefings — Check emails and mission files
4. Use the terminal — Type commands to investigate leads
5. Cross-reference data — Use the Database and Analyzer tools
6. Uncover the truth — Follow the evidence trail to expose the conspiracy

Terminal Commands

Command	Description
help	Show available commands
scan <target>	Scan a network target or IP address
decrypt <file>	Decrypt an encrypted file
trace <target>	Trace a network connection
analyze <file>	Run forensic analysis on a file
open <file>	Open a file from the virtual filesystem
ls	List files in current directory
cd <dir>	Change directory
clear	Clear the terminal

🏗️ Project Structure

acuity-os/
├── index.html      # Core HTML structure — boot screen, desktop, windows, menu bar
├── styles.css      # Premium glassmorphic design system with CRT effects
├── app.js          # Game engine — window manager, terminal, audio, story logic
└── README.md       # You are here

🛠️ Tech Stack

• HTML5 — Semantic structure with accessible markup
• CSS3 — Custom properties, glassmorphism, grid layouts, keyframe animations
• Vanilla JavaScript — ES6+ modules, Web Audio API, DOM manipulation
• Web Audio API — Procedural sound synthesis (clicks, chimes, alarms, ambient drones)
• Zero Dependencies — No npm, no build step, no frameworks

🎨 Design Philosophy

AcuityOS is designed to feel like a real operating system from a cyberpunk universe:

• Glassmorphism — Frosted glass panels with backdrop-filter: blur()
• CRT Scanlines — Retro monitor effect overlay
• Neon Palette — Cyan, magenta, and amber accents on deep dark backgrounds
• Monospace Typography — Terminal-authentic feel throughout
• Micro-animations — Subtle hover effects, typing animations, and glitch effects

📝 License

This project is open source and available under the MIT License.

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-case)
3. Commit your changes (git commit -m 'Add new investigation case')
4. Push to the branch (git push origin feature/new-case)
5. Open a Pull Request

📬 Contact

Built with ❤️ and a lot of caffeine.

---

"The truth is never where you first look for it." — Director Vance