projax 1.3.8 → 1.3.10

package/README.md

@@ -48,26 +48,93 @@ prx remove my-project
 prx remove my-project --force  # Skip confirmation
 ```
 
+### `prx pwd [project]`
+
+Get the path to a project directory (outputs just the path).
+
+```bash
+cd $(prx pwd 1)              # Change to project with ID 1
+cd $(prx pwd my-project)     # Change to project named "my-project"
+prx pwd                      # Interactive selection
+```
+
 ### `prx cd [project]`
 
-Get the path to a project directory for quick navigation. Use with command substitution to change directories.
+Change to a project directory. Outputs a shell command to change directory.
 
 ```bash
-cd $(prx cd 1)              # Change to project with ID 1
-cd $(prx cd my-project)     # Change to project named "my-project"
-prx cd                      # Interactive selection
+eval "$(prx cd 1)"              # Change to project with ID 1
+eval "$(prx cd my-project)"     # Change to project named "my-project"
+prx cd                          # Interactive selection
 ```
 
 **Tip:** For even easier navigation, add this to your shell config (`~/.zshrc` or `~/.bashrc`):
 
 ```bash
 prxcd() {
-  cd $(prx cd "$@")
+  eval "$(prx cd $@)"
 }
 ```
 
 Then you can simply use: `prxcd 1` or `prxcd my-project`
 
+### `prx run <project> <script>`
+
+Run a script from a project.
+
+**Options:**
+- `-b, --background`: Run script in background mode
+- `-f, --force`: Auto-resolve port conflicts
+
+```bash
+# Run in foreground
+prx run 1 dev
+prx run projax build
+
+# Run in background
+prx run 1 dev --background
+prx run projax dev -b
+
+# With force flag
+prx run 1 dev -f -b
+```
+
+### `prx ps`
+
+List all running background processes.
+
+```bash
+prx ps
+```
+
+### `prx stop <pid>`
+
+Stop a running background process by PID.
+
+```bash
+prx stop 12345
+```
+
+### `prx prxi` / `prx i`
+
+Launch the interactive terminal UI.
+
+```bash
+prx i        # Short alias
+prx prxi     # Full command
+```
+
+**Keyboard shortcuts:**
+- `↑/k` - Navigate up
+- `↓/j` - Navigate down
+- `Tab/←/→` - Switch panels
+- `s` - Scan project
+- `p` - Scan ports
+- `r` - Show scripts
+- `x` - Stop all project scripts
+- `?` - Help
+- `q/Esc` - Quit
+
 ### `prx <project> <script> [args...]`
 
 Run a script from a project's configuration file. Supports multiple project types:

package/dist/electron/main.js

@@ -65,7 +65,7 @@ else {
             width: 1200,
             height: 800,
             frame: false,
-            titleBarStyle: process.platform === 'darwin' ? 'hidden' : 'hidden',
+            titleBarStyle: 'hidden',
             webPreferences: {
                 preload: path.join(__dirname, 'preload.js'),
                 nodeIntegration: false,
@@ -95,6 +95,18 @@ else {
                 electron_1.app.quit();
             }
         }
+        // Handle external links securely
+        mainWindow.webContents.setWindowOpenHandler(({ url }) => {
+            // Only allow http/https links to be opened externally for security
+            const isExternal = url.startsWith('http:') || url.startsWith('https:');
+            if (isExternal) {
+                electron_1.shell.openExternal(url);
+                // Deny the default action of opening a new Electron window/tab
+                return { action: 'deny' };
+            }
+            // For internal or non-web links, allow the default behavior
+            return { action: 'allow' };
+        });
         mainWindow.on('closed', () => {
             mainWindow = null;
         });
@@ -382,8 +394,8 @@ electron_1.ipcMain.handle('get-running-processes', async () => {
     else {
         scriptRunnerPath = localScriptRunnerPath;
     }
-    const { getRunningProcesses } = await Promise.resolve(`${scriptRunnerPath}`).then(s => __importStar(require(s)));
-    return getRunningProcesses();
+    const { getRunningProcessesClean } = await Promise.resolve(`${scriptRunnerPath}`).then(s => __importStar(require(s)));
+    return await getRunningProcessesClean();
 });
 // Stop script by PID
 electron_1.ipcMain.handle('stop-script', async (_, pid) => {
@@ -430,7 +442,8 @@ electron_1.ipcMain.handle('open-url', async (_, url) => {
     else {
         corePath = localCorePath;
     }
-    const { getBrowserSettings } = await Promise.resolve(`${corePath}`).then(s => __importStar(require(s)));
+    const coreModule = require(corePath);
+    const { getBrowserSettings } = coreModule;
     const browserSettings = getBrowserSettings();
     let command;
     let args = [url];
@@ -520,7 +533,8 @@ electron_1.ipcMain.handle('open-in-editor', async (_, projectPath) => {
     else {
         corePath = localCorePath;
     }
-    const { getEditorSettings } = await Promise.resolve(`${corePath}`).then(s => __importStar(require(s)));
+    const coreModule = require(corePath);
+    const { getEditorSettings } = coreModule;
     const editorSettings = getEditorSettings();
     let command;
     let args = [projectPath];
@@ -606,3 +620,19 @@ electron_1.ipcMain.handle('save-settings', async (_, settings) => {
         throw error;
     }
 });
+// Open external URL securely (for anchor tags and manual calls)
+electron_1.ipcMain.on('open-external-url', (event, url) => {
+    try {
+        // SECURITY: Ensure only http/https links to prevent arbitrary file execution
+        const parsedUrl = new URL(url);
+        if (['http:', 'https:'].includes(parsedUrl.protocol)) {
+            electron_1.shell.openExternal(url);
+        }
+        else {
+            console.warn(`Blocked attempt to open non-http/https URL: ${url}`);
+        }
+    }
+    catch (error) {
+        console.error('Error opening external URL:', error);
+    }
+});

package/dist/electron/preload.d.ts

@@ -18,6 +18,11 @@ export interface ProjectPort {
     last_detected: number;
     created_at: number;
 }
+declare global {
+    interface Window {
+        electronAPI: ElectronAPI;
+    }
+}
 export interface ElectronAPI {
     getProjects: () => Promise<Project[]>;
     addProject: (path: string) => Promise<Project>;
@@ -83,4 +88,5 @@ export interface ElectronAPI {
             customPath?: string;
         };
     }) => Promise<void>;
+    openExternal: (url: string) => void;
 }

package/dist/electron/preload.js

@@ -24,6 +24,7 @@ electron_1.contextBridge.exposeInMainWorld('electronAPI', {
     stopProject: (projectPath) => electron_1.ipcRenderer.invoke('stop-project', projectPath),
     openUrl: (url) => electron_1.ipcRenderer.invoke('open-url', url),
     openInEditor: (projectPath) => electron_1.ipcRenderer.invoke('open-in-editor', projectPath),
+    openExternal: (url) => electron_1.ipcRenderer.send('open-external-url', url),
     getSettings: () => electron_1.ipcRenderer.invoke('get-settings'),
     saveSettings: (settings) => electron_1.ipcRenderer.invoke('save-settings', settings),
 });