SuperClaude-Org
diff --git a/‎.github/workflows/publish-pypi.yml‎
Lines changed: 10 additions & 10 deletions b/‎.github/workflows/publish-pypi.yml‎
Lines changed: 10 additions & 10 deletions
diff --git a/‎README.md‎
Lines changed: 100 additions & 72 deletions b/‎README.md‎
Lines changed: 100 additions & 72 deletions
diff --git a/‎SuperQwen/__init__.py‎
Lines changed: 3 additions & 0 deletions b/‎SuperQwen/__init__.py‎
Lines changed: 3 additions & 0 deletions
@@ -25,7 +25,7 @@ jobs:
   build-and-publish:
     name: Build and publish Python package
     runs-on: ubuntu-latest
-    environment: 
+    environment:
       name: ${{ github.event_name == 'release' && 'pypi' || 'testpypi' }}
       url: ${{ github.event_name == 'release' && 'https://pypi.org/p/SuperQwen' || 'https://test.pypi.org/p/SuperQwen' }}
 
@@ -62,25 +62,25 @@ jobs:
         import toml
         import sys
         sys.path.insert(0, '.')
-        
+
         # Load pyproject.toml version using dynamic version
         with open('pyproject.toml', 'r') as f:
             pyproject = toml.load(f)
-        
+
         # Load package version
         from SuperQwen import __version__
-        
+
         print(f'Package version: {__version__}')
         print(f'Dynamic version configured in pyproject.toml: {pyproject[\"tool\"][\"setuptools\"][\"dynamic\"][\"version\"]}')
-        
+
         # Since version is dynamic, we just verify the package can be imported
         print('✅ Version loaded successfully from package')
         "
-    
+
     - name: Clean previous builds
       run: |
         rm -rf dist/ build/ *.egg-info/
-    
+
     - name: Build package
       run: |
         echo "🔨 Building package..."
@@ -101,15 +101,15 @@ jobs:
         repository-url: https://test.pypi.org/legacy/
         password: ${{ secrets.TEST_PYPI_API_TOKEN }}
         print-hash: true
-    
+
     # Upload to production PyPI (only on releases)
     - name: Upload to PyPI
       if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'pypi')
       uses: pypa/gh-action-pypi-publish@release/v1
       with:
         password: ${{ secrets.PYPI_API_TOKEN }}
         print-hash: true
-    
+
     - name: Create deployment summary
       if: always()
       run: |
@@ -121,7 +121,7 @@ jobs:
         echo "| Version | $(python -c 'from SuperQwen import __version__; print(__version__)') |" >> $GITHUB_STEP_SUMMARY
         echo "| Commit | ${{ github.sha }} |" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
-        
+
         if [ "${{ github.event_name }}" == "release" ]; then
           echo "🎉 **Production release published to PyPI!**" >> $GITHUB_STEP_SUMMARY
           echo "Install with: \`pip install SuperQwen\`" >> $GITHUB_STEP_SUMMARY
 
@@ -4,100 +4,128 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python versions](https://img.shields.io/pypi/pyversions/SuperQwen.svg)](https://pypi.org/project/SuperQwen/)
 
-SuperQwen is an AI-enhanced development framework designed to supercharge your command-line workflow, forked from the original SuperClaude/SuperGemini projects. It provides structured development capabilities with a powerful command-line interface, specialized AI agents, and behavioral modes.
+**SuperQwen is an AI-enhanced development framework designed to supercharge your command-line workflow.**
 
-## Why SuperQwen?
+Forked from the original SuperClaude/SuperGemini projects, SuperQwen provides structured development capabilities with a powerful command-line interface, specialized AI agents, and behavioral modes to streamline your development process.
 
-- **Modern & User-Friendly**: A polished and intuitive command-line interface built with Typer and Rich.
-- **Granular Control**: Install and uninstall exactly the components you need (`commands`, `modes`, `agents`, etc.).
-- **Interactive Experience**: Run `superqwen install` for a guided, interactive setup.
-- **Self-Updating**: Keep your framework up-to-date with a simple `superqwen update` command.
-- **Extensible**: Easily add your own commands, agents, and modes to customize your workflow.
+## Key Features
+
+*   **✨ Modern & User-Friendly UI**: A polished and intuitive command-line interface with a custom UI for a consistent experience.
+*   **🧩 Modular Components**: Install and uninstall exactly the components you need (`commands`, `modes`, `agents`, etc.).
+*   **🤖 Interactive Experience**: Run `superqwen install` for a guided, interactive setup to get you started in seconds.
+*   **🚀 Self-Updating**: Keep your framework up-to-date with a simple `superqwen update` command.
+*   **🔧 Extensible by Design**: Easily add your own commands, agents, and modes to customize your workflow.
+*   **🧠 Intelligent MCP Integration**: Leverages the Model Context Protocol (MCP) for advanced, context-aware AI interactions.
 
 ---
 
 ## Installation
 
-Install the framework directly from PyPI:
+Install the framework directly from PyPI using pip:
 
 ```bash
 pip install SuperQwen
 ```
 
-After installation, set up the framework components using the interactive installer:
+After installation, it is highly recommended to run the interactive setup to install the core components:
 
 ```bash
 superqwen install
 ```
-This will present you with a checklist of components to install.
-
----
-
-## Usage
 
-The SuperQwen CLI (`superqwen`) is the main entry point for managing your framework.
+This will launch the interactive installer, allowing you to choose which components to set up.
 
-### CLI Screenshot
+### Installer Preview
 
 Here's a glimpse of the installer in action:
+
 ```
-$ superqwen install all
-
- =======================
-  SuperQwen_Framework
-    version 4.1.0-b2
-=======================
-[13:52:01] INFO     Installing Commands...
-           INFO     Copied 18 command files.
-           INFO     Installing Modes...
-           INFO     Copied 5 mode files.
-           INFO     Installing Agents...
-           INFO     Copied 13 agent files.
-           INFO     Installing MCP Config...
-           INFO     Configured verified MCP servers.
-Installing all components... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00
-
-✅ All components installed successfully!
+$ superqwen install
+
+============================================================
+                    SuperQwen Installer
+                     Interactive Setup
+NomenAK <[email protected]> | Mithun Gowda B <[email protected]>
+============================================================
+
+
+Installation Options
+====================
+1. Core Components (Commands, Modes, Agents)
+2. MCP Config (for advanced users)
+3. All of the above
+
+Enter your choice (1-3):
+> 3
+Ready to install the selected components? [Y/n]
+> y
+[INFO] Starting installation...
+[1/4] Installing commands...
+Commands: [██████████████████████████████████████████████████] 100.0% Complete
+[2/4] Installing modes...
+Modes:    [██████████████████████████████████████████████████] 100.0% Complete
+[3/4] Installing agents...
+Agents:   [██████████████████████████████████████████████████] 100.0% Complete
+[4/4] Installing mcp...
+Mcp:      [██████████████████████████████████████████████████] 100.0% Complete
+
+✅ Interactive installation complete!
 ```
 
+---
+
+## Usage
+
+The `superqwen` CLI is the main entry point for managing your framework.
+
 ### Core Commands
 
-- **`superqwen install [component]`**: Install components.
-  - `superqwen install all`: Install everything non-interactively.
-  - `superqwen install commands`: Install just the commands.
-  - `superqwen install`: Launch the interactive installer (recommended).
-- **`superqwen uninstall [component]`**: Uninstall components.
-  - `superqwen uninstall all`: Uninstall everything non-interactively.
-  - `superqwen uninstall`: Launch the interactive uninstaller.
-- **`superqwen update`**: Update the framework to the latest version from PyPI.
-- **`superqwen --help`**: Get help on any command or subcommand.
-
-Once installed, you can use the slash commands and modes within your Qwen CLI session.
-
-### Available Commands
-
-Here is a complete list of all available SuperQwen (`/sq`) commands.
-
-| Command | Description |
-|---|---|
-| `/sq:analyze` | Comprehensive code analysis across quality, security, performance, and architecture domains |
-| `/sq:build` | Build, compile, and package projects with intelligent error handling and optimization |
-| `/sq:cleanup` | Systematically clean up code, remove dead code, and optimize project structure |
-| `/sq:design` | Design system architecture, APIs, and component interfaces with comprehensive specifications |
-| `/sq:document` | Generate focused documentation for components, functions, APIs, and features |
-| `/sq:estimate` | Provide development estimates for tasks, features, or projects with intelligent analysis |
-| `/sq:explain` | Provide clear explanations of code, concepts, and system behavior with educational clarity |
-| `/sq:git` | Git operations with intelligent commit messages and workflow optimization |
-| `/sq:help` | List all available /sq commands and their functionality |
-| `/sq:implement` | Feature and code implementation with intelligent persona activation and MCP integration |
-| `/sq:improve` | Apply systematic improvements to code quality, performance, and maintainability |
-| `/sq:index` | Generate comprehensive project documentation and knowledge base with intelligent organization |
-| `/sq:load` | Session lifecycle management with Serena MCP integration for project context loading |
-| `/sq:reflect` | Task reflection and validation using Serena MCP analysis capabilities |
-| `/sq:save` | Session lifecycle management with Serena MCP integration for session context persistence |
-| `/sq:select-tool` | Intelligent MCP tool selection based on complexity scoring and operation analysis |
-| `/sq:test` | Execute tests with coverage analysis and automated quality reporting |
-| `/sq:troubleshoot` | Diagnose and resolve issues in code, builds, deployments, and system behavior |
+| Command                             | Description                                           |
+| ----------------------------------- | ----------------------------------------------------- |
+| `superqwen install`                 | Launch the interactive installer.                     |
+| `superqwen install all`             | Install all components non-interactively.             |
+| `superqwen install [component]`     | Install a specific component (e.g., `commands`).      |
+| `superqwen uninstall`               | Launch the interactive uninstaller.                   |
+| `superqwen uninstall all`           | Uninstall all components non-interactively.           |
+| `superqwen uninstall [component]`   | Uninstall a specific component.                       |
+| `superqwen update`                  | Update the framework to the latest version from PyPI. |
+| `superqwen --help`                  | Get help on any command or subcommand.                |
+
+
+### Available `/sq` Commands
+
+Once installed, you can use the following slash commands (`/sq:*`) within your Qwen CLI session to leverage the power of SuperQwen's AI agents.
+
+| Command         | Description                                                                          |
+| --------------- | ------------------------------------------------------------------------------------ |
+| `/sq:analyze`   | Comprehensive code analysis (quality, security, performance, architecture).          |
+| `/sq:build`     | Build, compile, and package projects with intelligent error handling.                |
+| `/sq:cleanup`   | Systematically clean up code, remove dead code, and optimize project structure.      |
+| `/sq:design`    | Design system architecture, APIs, and component interfaces.                          |
+| `/sq:document`  | Generate focused documentation for components, functions, APIs, and features.        |
+| `/sq:estimate`  | Provide development estimates for tasks, features, or projects.                      |
+| `/sq:explain`   | Provide clear explanations of code, concepts, and system behavior.                   |
+| `/sq:git`       | Git operations with intelligent commit messages and workflow optimization.           |
+| `/sq:help`      | List all available `/sq` commands and their functionality.                           |
+| `/sq:implement` | Feature and code implementation with intelligent persona activation.                 |
+| `/sq:improve`   | Apply systematic improvements to code quality, performance, and maintainability.     |
+| `/sq:index`     | Generate comprehensive project documentation and a knowledge base.                   |
+| `/sq:load`      | Session lifecycle management for loading project context via MCP.                    |
+| `/sq:reflect`   | Task reflection and validation using MCP analysis capabilities.                      |
+| `/sq:save`      | Session lifecycle management for persisting session context via MCP.                 |
+| `/sq:select-tool` | Intelligent MCP tool selection based on complexity scoring and operation analysis.   |
+| `/sq:test`      | Execute tests with coverage analysis and automated quality reporting.                |
+| `/sq:troubleshoot`| Diagnose and resolve issues in code, builds, deployments, and system behavior.     |
+
+---
+
+## Configuration
+
+### MCP Servers
+
+SuperQwen can integrate with Model Context Protocol (MCP) servers for advanced AI capabilities. During installation (`superqwen install mcp`), the installer will attempt to detect and configure any available MCP servers on your system.
+
+The configuration is saved in `~/.qwen/settings.json`. You can manually edit this file to add or modify MCP server configurations.
 
 ---
 
@@ -109,9 +137,9 @@ Contributions are welcome! Whether it's reporting a bug, suggesting a feature, o
 
 This project is licensed under the MIT License - see the `LICENSE` file for details.
 
-## Acknowledgment
+## Acknowledgments
 
 This framework was originally forked from the **SuperGemini Framework**. We sincerely thank the **SuperClaude Team** for their outstanding work, which served as the foundation and inspiration for this project.
 
-- https://github.com/SuperClaude-Org/SuperClaude_Framework
-- https://github.com/SuperClaude-Org/SuperGemini_Framework
+-   [SuperClaude Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework)
+-   [SuperGemini Framework](https://github.com/SuperClaude-Org/SuperGemini_Framework)
@@ -1 +1,4 @@
 __version__ = "1.0.0"
+__author__ = "NomenAK, Mithun Gowda B"
+__email__ = "[email protected], [email protected]"
+__github__ = "NomenAK, MithunGowdaB"