Luma Command

Luma Command is a cross-platform, launcher-first productivity tool for macOS and Windows. It is designed to open from a global hotkey, run fast local commands, and grow through user-defined plugins.

Name

Luma Command

Rationale:

• Luma suggests a small, focused source of light: quick context, quick action.
• Command makes the product category explicit without copying Raycast's name.
• The name is short enough for menus, logs, bundle identifiers, and CLI tooling.

Working identifiers:

• Product name: Luma Command
• Short name: Luma
• Repo name: luma-command
• App bundle candidate: com.luma.command

Current Stage

The project now has the first Electron + React + TypeScript application shell:

• Electron main process
• secure preload bridge
• React renderer
• typed shared contracts
• built-in command registry
• IPC-backed command search and execution
• diagnostics service
• global shortcut registration
• Settings and Diagnostics views
• metadata-only plugin manifest scanning
• managed plugin runtime execution for Node.js and Shell examples

The first runnable milestone is a minimal cross-platform command palette with:

• global hotkey invocation
• command search
• local plugin loading
• Node.js, Python, and Shell command execution
• a small built-in command set

Development

Install dependencies:

npm install

If Electron binary download is slow or incomplete, rebuild Electron with a mirror:

ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm rebuild electron

Run type checks:

npm run typecheck

Build main, preload, and renderer:

npm run build

Start the development app:

npm run dev

Default launcher shortcut:

CommandOrControl+Shift+Space

Example Plugins

Development builds scan examples/plugins in addition to the user plugin directory. The included Luma Examples plugin provides:

• Hello from Node
• Hello from Shell
• Hello from Python

Both commands are metadata-scanned at startup and only start their runtime when the command is executed.

Architecture

The architecture is documented in docs/project-architecture.md.

The short version:

• src/main owns Electron lifecycle, windows, IPC, command registry, platform adapters, diagnostics, plugin host, and runtime execution.
• src/preload exposes a narrow typed API through contextBridge.
• src/renderer owns the React UI only.
• src/shared owns cross-process contracts.
• Plugin runtimes should be managed jobs, not renderer privileges.