wipodev
diff --git a/‎README.md‎
Lines changed: 147 additions & 32 deletions b/‎README.md‎
Lines changed: 147 additions & 32 deletions
@@ -5,20 +5,19 @@
 </p>
 
 **EverMod CLI** is the official command-line tool for the [EverMod Framework](https://github.com/wipodev/EverMod).
-It provides a unified way to **create, organize, and maintain modular Minecraft Forge modding workspaces**.
-
-With a single command, you can generate new mods, manage templates, or collect source code for documentation — all from a single, consistent interface.
+designed to simplify the creation and management of **Minecraft Forge modding workspaces**.
+It helps you initialize workspaces, create mods, manage templates, and generate documentation packs for analysis or AI-assisted refactoring.
 
 ---
 
-## 🚀 Key Features
+## ✨ Features
 
-- 🧱 **Create ready-to-build Forge mods** using official EverMod templates.
-- 🔗 **Add external mods** as Git submodules with automatic workspace registration.
-- 📘 **Generate EverMix XML packages** for AI-assisted documentation and analysis.
-- 🔄 **Update templates** easily through the `update` command.
-- ⚙️ **Integrated release system** for internal packaging and version management.
-- 🪶 Works on **Windows**, **Linux**, and **macOS**.
+- Initialize Forge modding workspaces
+- Create new Forge mods from templates
+- Add EverMod support to existing projects
+- Manage multiple mods inside a single workspace
+- Update global templates easily
+- Generate _ContextPack_ XML files with full project context
 
 ---
 
@@ -42,46 +41,162 @@ This initializes your local EverMod template environment, preparing it for use.
 
 ---
 
-## 🧭 Basic Commands
+## 🚀 Basic Usage
 
-| Command                           | Description                                                 |
-| --------------------------------- | ----------------------------------------------------------- |
-| `evermod create <name> [version]` | Create a new mod project from a Forge MDK template.         |
-| `evermod add <user> <repo>`       | Add a mod from GitHub as a submodule.                       |
-| `evermod evermix [target]`        | Generate an EverMix XML package for documentation.          |
-| `evermod update [--force]`        | Update or reinstall the EverMod templates.                  |
-| `evermod refresh`                 | Refresh Gradle dependencies and Java indexes.               |
-| `evermod --version`               | Show version information for CLI, framework, and templates. |
+All commands follow this structure:
 
-> 💡 The `release` command is reserved for internal framework builds and is hidden from the public CLI help.
+```bash
+evermod <command> [options]
+```
+
+If no command is provided, EverMod will show the help menu.
 
 ---
 
-## 📚 Documentation
+## 🧩 Commands
+
+### `init` — Initialize a workspace
+
+Creates a new **workspace** directory prepared to host multiple mods.
+
+```bash
+evermod init
+```
+
+Optional:
+
+```bash
+evermod init --path <directory>
+```
+
+You will be prompted for:
+
+- Workspace name
+- Whether to include EverMod as a Git submodule
+
+---
+
+### `create` — Create a new mod
+
+Creates a new Forge mod from templates.
+
+```bash
+evermod create
+```
+
+Optional:
+
+```bash
+evermod create --space <workspace-path>
+```
+
+You will be prompted for:
+
+- Mod name and ID
+- Minecraft version
+- Author and package name
+- Whether to include EverMod (for standalone mods)
+
+If executed inside a workspace, the mod will be created under `mods/` automatically.
+
+---
+
+### `add` — Add EverMod to an existing project
+
+Adds EverMod support to an existing **mod** or **workspace**.
+
+```bash
+evermod add
+```
+
+Optional:
 
-Detailed documentation is available in the **[`docs/`](./docs/)** folder:
+```bash
+evermod add --path <project-path>
+```
+
+This will:
 
-- [User Guide (docs/)](./docs/) — installation, usage, and workspace setup.
-- [Technical Documentation](./docs/) — developer internals and release system.
+- Detect the project type
+- Update Gradle configuration
+- Add EverMod as a Git submodule
+- Generate an EverMod manifest
 
 ---
 
-## 🪄 Example Workflow
+### `update` — Update templates
+
+Updates the global Forge templates used by EverMod.
 
 ```bash
-# Update templates (first-time setup)
 evermod update
+```
 
-# Create a new mod project
-evermod create SilentMask 1.20.1
+Options:
 
-# Add an existing mod from GitHub
-evermod add wipodev John666
+```bash
+evermod update --force
+evermod update --silent
+```
+
+- `--force`: reinstall templates even if already up to date
+- `--silent`: run without prompts
+
+---
 
-# Generate EverMix documentation
-evermod evermix
+### `contextpack` — Generate ContextPack
+
+Generates a single XML file containing the structure and contents of the project.
+
+```bash
+evermod contextpack
 ```
 
+Optional:
+
+```bash
+evermod contextpack <target-path>
+```
+
+This is useful for:
+
+- Documentation
+- Debugging
+- Sharing project context with AI tools
+
+A configuration file (`ContextPack.config.json`) can be used to control exclusions.
+
+---
+
+### `--version` — Version information
+
+Shows CLI and template version information:
+
+```bash
+evermod --version
+```
+
+---
+
+## 📁 Project Structure
+
+EverMod projects include an `evermod.manifest.json` file used to track:
+
+- Project type (mod or workspace)
+- Minecraft versions
+- Installed mods
+- EverMod integration status
+
+This allows EverMod to work reliably across updates.
+
+---
+
+## 🧠 Notes
+
+- EverMod uses **Git submodules** to manage its framework
+- Gradle wrapper files are generated automatically
+- The CLI works interactively by default
+
 ---
 
 ## 👨‍💻 Author