# MemoryForge Ultimate 2.0

MemoryForge Ultimate is a premium, single-dashboard Windows resource-control application with a matching unattended CLI and optional Windows-service mode.

## Start the dashboard

Run `MemoryForge Ultimate.exe`. The published Windows x64 build is self-contained; .NET does not need to be installed. Normal launch uses the branded JVR splash with animated sparkles and a bottom-edge progress bar. `--startup` launches directly into the notification area.

In **Settings > Application**, **Start MemoryForge with Windows** creates or removes the current-user startup registration. When enabled, MemoryForge starts quietly in the notification area with its live RAM meter and automatic controls ready.

Run as Administrator for maximum-strength cache purge and service management. In **Settings > Application**, enable **Always start MemoryForge as Administrator** to save the preference and immediately relaunch through the standard Windows UAC prompt. Future dashboard and startup-shortcut launches request elevation automatically; turn the setting off to restore ordinary launch behavior. The preference is stored in `%LocalAppData%\MemoryForgeUltimate\settings.json`.

CLI elevation remains explicit with `--elevate`, and Windows-service mode already runs in its service security context. Monitoring, process browsing, OSD, Resource Pet, working-set trimming, and most controls work normally without elevation.

## Dashboard features

- Live RAM, CPU, disk, network, process, NVIDIA GPU, VRAM, and GPU temperature telemetry
- Dynamic per-logical-processor CPU percentage tiles that automatically wrap for the detected processor count
- Physical NVIDIA adapter detection (not virtual/Meta display adapters)
- Original-strength Clear RAM working-set sweep and Clear RAM + Cache with native system-cache reduction plus standby-list purge
- Auto Optimize and the complete Run All 24 pipeline with honest per-stage outcomes
- Searchable process table, priority control, graceful End Task, Force Kill, and Kill Tree
- Game Mode with high-performance power plan, selected-game priority, and persistent rollback data
- Automatic RAM-pressure trigger with a sustained threshold and cooldown
- Optional performance OSD, full-width cleaning progress OSD, and result OSD
- Full-screen display test
- Optional selectable animated Resource Pet: original frame-animated Pixel Robot plus Nova, Skye, Atlas, Teddy and Cyber Fox each with four true poses plus randomized idle breathing, bounce, curious tilt, side drift, energy pulse and hover motion
- Live tray RAM meter with colour state, RAM percentage, RAM tooltip, clean quick actions, and Show/Hide Resource Pet control
- Silent dashboard completion reporting and responsive pressed/working button states
- Persistent Start with Windows toggle for quiet notification-area startup
- Persistent optional Always Start as Administrator setting with immediate UAC relaunch
- Dark high-contrast interface with no promotional notifications or junk tray items

## CLI

Use the same executable. CLI mode does not construct the dashboard or tray icon.

```powershell
& '.\MemoryForge Ultimate.exe' --cli help
& '.\MemoryForge Ultimate.exe' --cli status --verbose
& '.\MemoryForge Ultimate.exe' --cli clean-ram
& '.\MemoryForge Ultimate.exe' --cli clean-ram-cache --show-osd --show-results
& '.\MemoryForge Ultimate.exe' --cli run-all-24 --verbose
& '.\MemoryForge Ultimate.exe' --cli processes --filter chrome --top 20
& '.\MemoryForge Ultimate.exe' --cli pet-test --character Skye
& '.\MemoryForge Ultimate.exe' --cli monitor --threshold 82 --interval 5 --trigger-seconds 15 --cooldown 300
```

Add `--json` for machine-readable output, `--quiet` for exit-code-only operation, `--output PATH` for a log/result file, or `--dry-run` to validate an action without changing the system. Add `--elevate` when a CLI command needs the original Administrator-only cache engine. The dashboard requests Administrator approval automatically only for privileged cache cleaning, preserving quiet startup. Force Kill and Kill Tree require `--yes`.

See `MemoryForgeUltimate-CLI-Reference.md` in the release folder for every command.

## Windows service

The service runs the same sustained-threshold monitor without a desktop session, dashboard, OSD, pet, or tray icon. From an Administrator PowerShell terminal:

```powershell
& '.\MemoryForge Ultimate.exe' --cli install-service --threshold 82 --interval 5 --trigger-seconds 15 --cooldown 300 --cache
& '.\MemoryForge Ultimate.exe' --cli start-service
& '.\MemoryForge Ultimate.exe' --cli service-status
& '.\MemoryForge Ultimate.exe' --cli stop-service
& '.\MemoryForge Ultimate.exe' --cli uninstall-service
```

Use `install-service --dry-run` first if desired. The installed service points to the current executable path, so place the EXE in its permanent location before installing. Service activity is logged at `%ProgramData%\MemoryForgeUltimate\service.log`.

## Safety

Critical Windows processes are protected. RealTime process priority is intentionally blocked. Destructive process commands require explicit confirmation. MemoryForge does not invent temperature, optimization, or recovery results. CPU temperature remains unavailable unless a verified provider is added; physical NVIDIA telemetry uses `nvidia-smi`.

## Resource Pet asset

Pixel Robot by Charles Gabriel, via OpenGameArt.org, licensed CC0 1.0 Universal: https://opengameart.org/content/pixel-robot

Nova, Skye, Atlas, Teddy and Cyber Fox were generated specifically for MemoryForge Ultimate and are bundled as application artwork.