Spotlight Control Center

[BYK]

Closes #1136.

Spotlight Control Center

This PR introduces the Spotlight Control Center, enabling users to manage all spotlight run instances from a centralized UI or via a new spotlight list CLI command.

Key Features:

• Instance Registry: Tracks all spotlight run instances, including health checks (HTTP, PID, start time) and automatic cleanup of stale entries.
• spotlight list CLI Command: A new command to list running instances with support for human, JSON, logfmt, and Markdown output formats.
• API Endpoints: Provides endpoints for listing, pinging, and terminating instances.
• Control Center UI: A new UI section to view, search, connect to, and terminate instances in real-time.
• Connection Switching: Allows seamless switching between active Spotlight instances with a clean state reset.
• Cross-Platform Support: Implemented using pidusage for robust process management across Linux, macOS, and Windows.

Why this change?

This feature addresses the need for better visibility and control over multiple running Spotlight instances, improving the developer experience by simplifying instance management and debugging.

Testing Notes:

• The CLI functionality (spotlight list and instance registration) has been thoroughly tested and verified.
• UI components are built and integrated; manual UI interaction testing is recommended to verify connection switching and instance termination from the browser.

---

 

[vercel[bot]]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
spotlightjs	Ready	Preview	Comment	Nov 20, 2025 0:22am