🚀 My-System: Autonomous Developer OS

My-System is a production-grade, high-performance developer workspace orchestrator. It transforms your local machine into an Autonomous OS, automating environment management, service orchestration, and diagnostic repairs with a focus on Stability, Security, and UX.

🏗️ Architecture Overview

My-System follows a modular, decoupled architecture designed for speed and safety. It operates as a "Cerebrum" for your development environment.

graph TD
    UI[Tauri Desktop App] -- RPC/Invoke --> Rust[Tauri Backend]
    Rust -- Spawns --> Sidecar[Node.js Sidecar]
    Sidecar -- Orchestrates --> Core[Core Engine]
    
    subgraph Core
        System[System Layer: State, Logger, Events, Governor]
        Runtime[Runtime Layer: ServiceManager, PluginLoader]
        Intel[Intelligence Layer: ErrorAnalyzer, SuggestionEngine]
    end
    
    Core -- Detects --> Crashes
    Crashes -- Triggers --> Recovery[Recovery System]
    Recovery -- Fallback --> SafeMode[Safe Mode Protection]
    
    System -- Monitors --> Pressure["System Pressure (CPU/RAM)"]

💎 Key Features

🛡️ 1. Stability & Safety Layer

• Global Error Guardian: Advanced catch-all error handling that prevents silent crashes and logs deep diagnostics to logs/diagnostic.log.
• Intelligent Recovery: ServiceManager will attempt autonomous recoveries (default: 2) for any crashed service before entering Safe Mode.
• Resource Governor: Real-time monitoring of CPU and RAM pressure. Automatically throttles non-essential tasks during high load.
• Idempotent Commands: Every command is state-aware. Running init multiple times is safe and non-destructive.

🧠 2. Neural Intelligence Core

• Error Analyzer: Deciphers complex stack traces and provides human-readable explanations.
• Suggestion Engine: Proactively suggests environment fixes (missing deps, port conflicts, .env mismatches).
• Explain Command: Use xeyal-system explain "error message" to get AI-powered diagnostic insights instantly.

🔐 3. Enterprise-Grade Security

• Permission System: Built-in capability manager controlling READ, WRITE, and EXECUTE scopes for all operations.
• Plugin Sandbox: External plugins run in a restricted environment with a secure API (safeApi), preventing unauthorized shell execution.
• Safe Mode: Dangerous operations (killing processes, deleting cache) require explicit mode toggles or user confirmation.

🖥️ 4. Premium Desktop Experience

• Native Desktop App: A high-tech frontend built with Tauri (Rust backend) for real-time monitoring and resource management.
• Log Streaming: Integrated color-coded log streaming directly from the CLI sidecar to the desktop dashboard.

📂 Project Structure

| Directory | Purpose | | :--- | :--- | | cli/ | Entry points, CLI routing, and Onboarding logic. | | core/system/ | Base layers: State, Logging, Event Bus, Governor, Profiler. | | core/runtime/ | Execution: Service lifecycle, Plugin loading, Port management. | | core/intelligence/ | Logic: Error Analysis, Suggestion Engine, Global trapping. | | desktop-app/ | Tauri source code (Rust backend + Vanilla JS frontend). | | plugins/ | User-defined system extensions & Sandboxed modules. |

🔐 Security & Privacy Promise

Running a system that orchestrates your workspace requires absolute trust. We’ve built My-System with three non-negotiable pillars:

🔒 1. 100% Local-Only

• No Telemetry: We do not collect usage data, heap snapshots, or environment variables.
• Offline-First: The core engine and the Tauri desktop app communicate via localized IPC/RPC. No external server is ever pinged.

🛡️ 2. Safe Mode by Default

• Restricted Execution: Dangerous actions (like killing processes or deep cleaning directories) are blocked unless you explicitly enable AutoPilot.
• Conflict Resolution: Instead of silently resolving port conflicts, the system asks for your permission or provides a suggestion you can manualy trigger.

🔌 3. Sandboxed Plugins Loader

• Plugins cannot access your file system outside the workspace.
• They utilize a filtered safeExec handler that blocks high-risk shell commands (e.g., rm -rf /, curl | bash).

🚀 Getting Started

Quick Start (No Install)

Run My-System instantly:

npx xeyal-system dev

Permanent Global Installation

npm install -g xeyal-system
xeyal-system dev

Simulation Mode (Dry Run)

Test any command without making changes:

xeyal-system clean --simulate

📟 CLI Command Reference

| Command | Description | Example | | :--- | :--- | :--- | | Basic | | | | init | Setup fresh environment and configuration files | xeyal-system init | | dev | Start the development stack + Intelligent Dashboard | xeyal-system dev | | doctor | Deep hardware & software environment diagnostic | xeyal-system doctor | | Project | | | | open [path] | Register and open a project in IDE | xeyal-system open ./my-app | | list | Show all registered projects and their status | xeyal-system list | | switch [name] | Change active project context | xeyal-system switch api-service | | Maintenance | | | | fix [port] | Auto-repair environment or kill specific port | xeyal-system fix 3000 | | clean | Deep cleanup of modules, logs, and cache | xeyal-system clean | | Advanced | | | | explain <msg> | Get AI-powered diagnostic for an error message | xeyal-system explain "EADDRINUSE" | | autopilot | Toggle autonomous repair mode (on/off) | xeyal-system autopilot on | | status | CLI health dashboard and system metrics | xeyal-system status | | cockpit | Launch the tactical TUI interface | xeyal-system cockpit |

🔌 Plugin Development

Plugins extend the system safely via the safeApi:

export default {
    register: (program, safeApi) => {
        safeApi.logger.info("Plugin Active!");
        
        program.command('hello')
            .action(() => {
                // Restricted execution via Sandbox
                safeApi.safeExec('echo "Hello World"');
            });
    }
}

🤝 Support & Contribution

Built with ❤️ by Antigravity. If you find a bug or have a feature request, please open an issue!