feat: Improved README

Author: kevinwang5658

README.md

@@ -2,7 +2,7 @@
 
 **Stop manually setting up your development environment. Define it once, replicate it everywhere.**
 
-Codify is a command-line tool that brings the power of Infrastructure as Code (IaC) to your local development machine. Manage system settings, install packages, configure tools, and automate your entire setup using a simple, declarative configuration file—just like you manage your infrastructure with Terraform.
+Codify is a command-line tool that brings the power of Infrastructure as Code (IaC) to your local development machine. Manage system settings, install packages, configure tools, and automate your setup using a simple, declarative configuration file. It's like Terraform but for your local machine.
 
 <p align="center">
   <a href="https://codifycli.com">Website</a> •
@@ -24,7 +24,6 @@ Every developer has been there:
 - **New machine?** Spend hours reinstalling and configuring everything
 - **Team onboarding?** Send them a scattered wiki page of manual installation steps
 - **Multiple machines?** Keep them in sync manually
-- **What's installed?** No clear record of your development environment
 - **Configuration drift?** Your laptop works differently than your colleague's
 
 ## The Solution
@@ -47,19 +46,19 @@ With Codify, your entire development environment is defined in a single `codify.
 ```
 
 Now you can:
-- ✅ **See what changes** before applying them with `codify plan`
-- ✅ **Apply changes** automatically with `codify apply`
-- ✅ **Version control** your environment setup
-- ✅ **Share configurations** with your team
-- ✅ **Replicate setups** across multiple machines in minutes
+- **See what changes** before applying them with `codify plan`
+- **Apply changes** automatically with `codify apply`
+- **Version control** your environment setup
+- **Share configurations** with your team
+- **Replicate setups** across multiple machines in minutes
 
 ## Key Features
 
-### 🎯 **Declarative Configuration**
+### **Declarative Configuration**
 Define your entire development environment in a single, readable configuration file. No more shell scripts or scattered installation instructions.
 
-### 🔍 **Plan Before You Apply**
-Like Terraform, Codify shows you exactly what changes will be made before executing them. No surprises.
+### **Plan Before You Apply**
+Like Terraform, Codify shows you exactly what changes will be made before executing them.
 
 ```bash
 $ codify plan
@@ -87,8 +86,8 @@ Do you want to apply the above changes?
   No
 ```
 
-### 📥 **Import Your Current Setup**
-Already have a configured machine? Generate a Codify configuration from your existing setup in seconds:
+### **Import Your Current Setup**
+Already have a configured machine? Generate a Codify configuration from your existing setup:
 
 ```bash
 $ codify init
@@ -109,7 +108,7 @@ Use <space> to select and <return> to submit.
 Use <a> to select all items and <d> to de-select all items.
 ```
 
-### 🔌 **Extensible Plugin System**
+### **Extensible Plugin System**
 Out-of-the-box support for:
 - **Homebrew** (formulae and casks)
 - **VS Code** (extensions and settings)
@@ -118,20 +117,19 @@ Out-of-the-box support for:
 - **Git** configuration
 - And [many more](https://docs.codifycli.com/plugins)...
 
-Don't see what you need? Create your own plugin in minutes.
+Don't see what you need? [Create your own plugin](https://codifycli.com/docs/plugins).
 
-### 🌐 **Web-Based Editor**
-Edit your configuration in a beautiful web interface at [dashboard.codifycli.com](https://dashboard.codifycli.com):
-- 🎨 Intuitive UI with auto-completion
-- 🔄 Real-time validation
-- ☁️ Cloud sync across devices
-- 🤝 Share configurations with your team
+### **Web-Based Editor**
+Edit your configuration in a web interface at [dashboard.codifycli.com](https://dashboard.codifycli.com):
+- Intuitive UI with auto-completion
+- Real-time validation
+- Cloud sync across devices
+- Share configurations with your team
 
-### 🔒 **Safe & Secure**
+### **Safe & Secure**
 - Preview all changes before applying
-- Sudo password prompts only when needed
-- Secure mode for extra protection
-- Open source and Apache 2.0 licensed
+- Both the CLI tool and default plugin are open source and Apache 2.0 licensed
+- Requests your password each time elevated privileges (sudo) is required.
 
 ## Quick Start
 
@@ -175,14 +173,6 @@ codify plan
 codify apply
 ```
 
-### Pro Tip: Use the Web Editor
-
-Visit [dashboard.codifycli.com](https://dashboard.codifycli.com) for a guided, visual way to build your configuration with:
-- Auto-complete for all available packages
-- Real-time validation
-- Cloud storage and sync
-- Shareable configurations
-
 ## Common Commands
 
 | Command             | Description                                                    |
@@ -198,26 +188,6 @@ Visit [dashboard.codifycli.com](https://dashboard.codifycli.com) for a guided, v
 
 Run `codify --help` for a complete list of commands and options.
 
-## Real-World Use Cases
-
-### **Individual Developers**
-- Keep multiple machines (work laptop, personal laptop, desktop) in sync
-- Quickly recover from system reinstalls or upgrades
-- Document your development environment as code
-- Try out new tools without the hassle of installing them
-
-### **Development Teams**
-- Onboard new developers in minutes instead of days
-- Ensure everyone has the same development environment
-- Share team configurations via Git or the [Codify editor](https://dashboard.codifycli.com)
-- Reduce "works on my machine" problems
-
-### **Organizations**
-- Standardize development environments across teams
-- Maintain compliance with required tools and versions
-- Reduce IT support burden for developer setup
-- Break down barriers between teams and departments
-
 ## Example Configurations
 
 ### Full-Stack JavaScript Developer
@@ -298,41 +268,21 @@ Run `codify --help` for a complete list of commands and options.
 ]
 ```
 
-## Why Codify vs. Alternatives?
-
-| Feature                          | Codify | Homebrew Bundle | Shell Scripts | Manual Setup |
-|----------------------------------|:------:|:---------------:|:-------------:|:------------:|
-| Declarative configuration        | ✅      | ✅               | ❌            | ❌           |
-| Plan before apply                | ✅      | ❌               | ❌            | ❌           |
-| Import existing setup            | ✅      | ❌               | ❌            | ❌           |
-| Multi-format support             | ✅      | ❌               | ❌            | ❌           |
-| Web-based editor                 | ✅      | ❌               | ❌            | ❌           |
-| Cross-tool management            | ✅      | ❌               | ⚠️            | ❌           |
-| Extensible plugins               | ✅      | ❌               | ⚠️            | ❌           |
-| Cloud sync                       | ✅      | ❌               | ❌            | ❌           |
-| Update detection                 | ✅      | ✅               | ❌            | ❌           |
-
 ## Frequently Asked Questions
 
 **Q: Does Codify work on Linux and Windows?**
 A: Codify currently supports macOS and Linux. Windows support works via WSL.
 
-**Q: Can I use Codify with my existing Homebrew setup?**
-A: Yes! Run `codify init` to import your existing packages into a Codify configuration.
-
-**Q: Is my sudo password stored?**
-A: No. Codify only caches your password in memory during a session and prompts when needed. Use `--secure` mode for extra protection.
-
 **Q: How is this different from Ansible/Chef/Puppet?**
 A: Those tools are designed for server configuration management. Codify is purpose-built for local development environments with a focus on simplicity and developer experience.
 
 ## Community & Support
 
-- 📚 **Documentation**: [docs.codifycli.com](https://docs.codifycli.com)
-- 🐛 **Issues**: [GitHub Issues](https://github.com/codifycli/codify/issues)
-- 💬 **Default Plugin**: [GitHub Default Plugin](https://github.com/codifycli/default-plugin)
-- 🌐 **Website**: [codifycli.com](https://codifycli.com)
-- ☁️ **Editor**: [dashboard.codifycli.com](https://dashboard.codifycli.com)
+- **Documentation**: [docs.codifycli.com](https://docs.codifycli.com)
+- **Issues**: [GitHub Issues](https://github.com/codifycli/codify/issues)
+- **Default Plugin**: [GitHub Default Plugin](https://github.com/codifycli/default-plugin)
+- **Website**: [codifycli.com](https://codifycli.com)
+- **Editor**: [dashboard.codifycli.com](https://dashboard.codifycli.com)
 
 ## Contributing