Parad0x Command

Local-first desktop command center for apps, processes, browser activity, files, agents, and system telemetry.

Owner: Parad0x Labs
Contributor: @sls_0x
License: MIT (see LICENSE)

What You Get

• Live system graph with apps, processes, files, hardware, and browser activity.
• SYSTEM view for operational control and AI MAP view for live agent activity.
• Multiple draggable inspector cards for side-by-side comparison.
• Local process controls and network cut/restore controls.
• No cloud dependency; local-only by default.

Quick Start

One-command setup from GitHub

macOS / Linux

git clone https://github.com/Parad0x-Labs/Parad0x-Command.git && cd Parad0x-Command && bash ./setup.sh

Windows (PowerShell)

git clone https://github.com/Parad0x-Labs/Parad0x-Command.git; Set-Location .\Parad0x-Command; .\setup.ps1

Windows (CMD)

git clone https://github.com/Parad0x-Labs/Parad0x-Command.git && cd Parad0x-Command && setup.bat

Setup from an extracted folder

bash ./setup.sh

.\setup.ps1

setup.bat

Launch

Preferred launchers

Start Parad0x Command on Windows.cmd
Start Parad0x Command on Linux.sh
Start Parad0x Command on macOS.command

Direct terminal launch

powershell -NoProfile -ExecutionPolicy Bypass -File .\run_parad0x_command_export.ps1

bash ./run_parad0x_command_export.sh

Direct CLI

Live browser UI:

./parad0x-command live . --workspace . --desktop --port 8776

Native window mode:

./parad0x-command native . --workspace . --desktop --port 8774

V2: AI MAP

AI MAP turns the system view into a live agent activity map:

• Agent nodes with orbiting task, token, process, and status signals.
• Memory files glow when active or referenced.
• Live edges pulse on recent activity.
• Multiple inspector cards for comparison.
• The AI MAP uses the same local data plane as SYSTEM, not a separate remote service.

SDK / Agent Integration

Parad0x Command is local-first but still automation friendly:

• Local HTTP API over 127.0.0.1 with per-run token auth.
• JSON responses for system and AI activity snapshots.
• For agent-facing usage, see AGENTS.md.

Security Model

Parad0x Command is local-first and includes explicit protections around its localhost control surface.

• The server binds to 127.0.0.1 only.
• Each run generates a random in-memory API token.
• /api/* requests must present that token.
• Dangerous actions require authenticated POST, not unauthenticated GET.
• Loopback Host plus origin or referrer checks are enforced where relevant.
• Wildcard CORS was removed, so normal websites cannot read local stats from the running session.

Practical meaning:

• Other machines cannot directly reach it over the network in the default setup.
• The local control surface is substantially more resistant to unauthorized browser-triggered requests than a raw unauthenticated localhost panel.
• It is a local desktop tool, not a multi-user remote control server.

Platform Notes

Browser visibility is platform-dependent:

• macOS Safari provides the strongest live tab visibility.
• Windows Chrome or Edge work best when the browser exposes a Chromium debug endpoint.
• Linux works best on a full desktop session with accessible browser or X11 session data.
• Linux VM, VNC, stripped desktop, or locked-down Wayland sessions can expose much less metadata.

If Chrome or Edge needs stronger tab visibility on Windows or Linux, launch the browser with:

--remote-debugging-port=9222

Windows and Linux can fall back to browser window titles when true per-tab metadata is unavailable.

Operational Notes

• Multiple inspector cards can remain open at the same time.
• Wi-Fi cut on Windows prefers WLAN disconnect.
• Wi-Fi restore on Windows prefers reconnecting the previously used Wi-Fi profile.
• Adapter disable or enable is only a fallback path.

Resource Snapshot

Observed on an active Safari tab during testing:

• Traffic pulse: 100%
• Safari CPU share: 41.9%
• Approx CPU load: 0.42 / 10 core-equiv
• Safari memory share: 0.8%
• Approx Safari RAM: 196.6 MB

These values depend on the active tab and all other foreground or background processes. They can be lower or much higher in real use.

Share values are estimated from the current Safari family load, not total machine usage.

Included Launchers

• Start Parad0x Command on Windows.cmd
• Start Parad0x Command on Linux.sh
• Start Parad0x Command on macOS.command
• run_parad0x_command_export.ps1
• run_parad0x_command_export.sh
• parad0x-command

Repository

Product name:

• Parad0x Command

GitHub repository slug:

• Parad0x-Command