cloud-pc-templates 1.1.2 → 1.2.0

package/README.md

@@ -0,0 +1,260 @@
+# Cloud PC Templates
+
+Cloud PC Templates is a command-line tool for managing cloud PC configurations and AI operations.
+
+## Installation
+
+```bash
+npm install -g cloud-pc-templates
+```
+
+## Usage
+
+### Basic Commands
+
+Display help information:
+```bash
+npx cloud-pc-templates
+npx cloud-pc-templates help
+npx cloud-pc-templates --help
+```
+
+### Launch Website
+
+Open the Cloud PC Templates website in your default browser:
+```bash
+npx cloud-pc-templates launch
+```
+
+This command will open `https://cloud-pc-templates.com` in your browser.
+
+### AI Operations
+
+#### AI Login
+
+The AI module provides login functionality for different cloud providers.
+
+##### Ollama Cloud Login
+
+Connect to Ollama Cloud:
+```bash
+npx cloud-pc-templates ai login loginMode ollamacloud
+```
+
+**What it does:**
+1. Checks if you're already logged in by testing the health endpoint at `http://localhost:3004/health`
+2. If already logged in, displays "Already logged in" message
+3. If not logged in:
+   - Prompts you to enter your API Key (masked input with asterisks)
+   - Downloads the Ollama proxy script from GitHub
+   - Runs the proxy with your API key as an argument
+   - Validates the health endpoint
+   - Displays "Logged in" confirmation
+
+**Example:**
+```bash
+$ npx cloud-pc-templates ai login loginMode ollamacloud
+Enter API Key: **************************
+✓ Logged in
+  - Endpoint checked: http://localhost:3004/health
+```
+
+**Features:**
+- Masked input for API key (shows `*` instead of actual characters)
+- Supports pasting long API keys
+- Backspace support for corrections
+- Cross-platform terminal support (TTY and non-TTY)
+- Real-time proxy output logging for debugging
+
+##### Ollama Local Login
+
+Connect to Ollama Local instance:
+```bash
+npx cloud-pc-templates ai login loginMode ollamalocal
+```
+
+**What it does:**
+- Initializes connection to your local Ollama installation
+- Displays connection status
+
+**Example:**
+```bash
+$ npx cloud-pc-templates ai login loginMode ollamalocal
+✓ AI Login initialized with mode: ollamalocal
+  - Connecting to Ollama Local...
+  - Initializing local connection...
+```
+
+### Command Discovery
+
+The CLI features intelligent command discovery. If you don't provide all required arguments, it shows available options:
+
+```bash
+$ npx cloud-pc-templates ai
+Available options for: npx cloud-pc-templates ai
+
+  login                - Login to AI service
+
+$ npx cloud-pc-templates ai login
+Available options for: npx cloud-pc-templates ai login
+
+  loginMode           - Specify login mode
+
+$ npx cloud-pc-templates ai login loginMode
+Available options for: npx cloud-pc-templates ai login loginMode
+
+  ollamacloud         - Connect to Ollama Cloud
+  ollamalocal         - Connect to Ollama Local
+```
+
+## Architecture
+
+The project follows a modular handler-based architecture:
+
+```
+cloud-pc-templates/
+├── index.js                 # Main entry point, command tree, and CLI routing
+├── handlers/
+│   ├── ollamacloud.js      # Ollama Cloud login functionality
+│   └── launch.js           # Website launcher
+├── package.json            # Project metadata and bin configuration
+└── README.md               # This file
+```
+
+### Modules
+
+#### index.js
+- **Command Tree**: Hierarchical command structure supporting nested subcommands
+- **Argument Parsing**: Handles command-line arguments with `--` prefix stripping
+- **Request Routing**: Routes commands to appropriate handlers
+
+#### handlers/ollamacloud.js
+- `promptForApiKey()`: Interactive masked API key input
+- `checkHealthEndpoint()`: Health check for proxy server
+- `downloadAndRunProxy()`: Downloads and executes proxy script with API key
+- `checkAndLoginOllamaCloud()`: Main login orchestrator
+
+#### handlers/launch.js
+- `openBrowser()`: Cross-platform browser launcher
+- `launchWebsite()`: Opens cloud-pc-templates.com
+
+## Features
+
+### Masked API Key Input
+When logging in to Ollama Cloud, your API key is protected:
+- Each character you type displays as an asterisk `*`
+- Works with keyboard input and pasted text
+- Supports backspace for corrections
+
+### Cross-Platform Support
+The launch command works on:
+- macOS (uses `open` command)
+- Linux (uses `xdg-open` command)
+- Windows (uses `start` command)
+
+### Health Check System
+The Ollama Cloud login includes automatic health checking:
+- Validates server is ready before completing login
+- Provides endpoint information for debugging
+- Includes detailed output from proxy process
+
+### Intelligent Command Discovery
+The CLI provides helpful feedback when commands are incomplete:
+- Shows available options at each level
+- Supports `--help` flag at any point
+- Clear, formatted output with descriptions
+
+## Development
+
+### File Structure
+```
+handlers/
+├── ollamacloud.js         # Ollama Cloud specific logic
+└── launch.js              # Launch specific logic
+```
+
+Each handler is a separate module that can be:
+- Independently tested
+- Updated without affecting other modules
+- Extended with new features
+- Reused in other projects
+
+### Adding New Commands
+
+To add a new command:
+
+1. Create a new handler file in `handlers/`:
+```javascript
+// handlers/mycommand.js
+async function myCommandHandler() {
+  // Implementation
+}
+
+module.exports = { myCommandHandler };
+```
+
+2. Import it in `index.js`:
+```javascript
+const { myCommandHandler } = require('./handlers/mycommand');
+```
+
+3. Add it to the command tree:
+```javascript
+const commandTree = {
+  // ... existing commands
+  mycommand: {
+    description: 'My command description',
+    handler: () => myCommandHandler()
+  }
+};
+```
+
+## NPM Script
+
+The project is configured with a binary entrypoint in `package.json`:
+
+```json
+{
+  "bin": {
+    "cloud-pc-templates": "index.js"
+  }
+}
+```
+
+This enables the `npx cloud-pc-templates` command globally.
+
+## API Key Security
+
+When entering your API key:
+- Input is masked with asterisks
+- Key is passed directly to the proxy process
+- Never logged or stored in plain text
+- Passed via command-line argument or environment variable
+
+## Troubleshooting
+
+### "Unknown command" error
+- Make sure you've spelled the command correctly
+- Use `npx cloud-pc-templates help` to see available commands
+- Commands are case-sensitive
+
+### Ollama Cloud login fails
+- Check that you have a valid API key
+- Ensure your network connection is stable
+- Try checking if the health endpoint is accessible manually:
+  ```bash
+  curl http://localhost:3004/health
+  ```
+
+### Browser won't open with `launch`
+- Ensure you have a default browser configured
+- On Linux, make sure `xdg-open` is installed: `sudo apt-get install xdg-utils`
+- On Windows, ensure a browser is set as default
+
+## License
+
+ISC
+
+## Author
+
+Cloud PC Templates Contributors

package/handlers/launch.js

@@ -0,0 +1,51 @@
+const { exec } = require('child_process');
+const os = require('os');
+
+// Function to open URL in default browser
+function openBrowser(url) {
+  return new Promise((resolve, reject) => {
+    let command;
+    
+    switch (os.platform()) {
+      case 'darwin':
+        // macOS
+        command = `open "${url}"`;
+        break;
+      case 'linux':
+        // Linux
+        command = `xdg-open "${url}"`;
+        break;
+      case 'win32':
+        // Windows
+        command = `start "${url}"`;
+        break;
+      default:
+        reject(new Error(`Unsupported platform: ${os.platform()}`));
+        return;
+    }
+    
+    exec(command, (error) => {
+      if (error) {
+        reject(error);
+      } else {
+        resolve();
+      }
+    });
+  });
+}
+
+// Function to launch cloud-pc-templates website
+async function launchWebsite() {
+  try {
+    console.log('🚀 Launching cloud-pc-templates.com...');
+    await openBrowser('https://cloud-pc-templates.com');
+    console.log('✓ Browser opened successfully');
+  } catch (error) {
+    console.error('Error launching browser:', error.message);
+  }
+}
+
+module.exports = {
+  launchWebsite,
+  openBrowser
+};

package/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 const { checkAndLoginOllamaCloud } = require('./handlers/ollamacloud');
+const { launchWebsite } = require('./handlers/launch');
 
 // Command tree structure
 const commandTree = {
@@ -31,6 +32,10 @@ const commandTree = {
         }
       }
     }
+  },
+  launch: {
+    description: 'Launch cloud-pc-templates.com in browser',
+    handler: () => launchWebsite()
   }
 };
 
@@ -43,6 +48,7 @@ function help() {
   console.log('  npx cloud-pc-templates help     Show this help message');
   console.log('  npx cloud-pc-templates --help   Show this help message');
   console.log('  npx cloud-pc-templates ai       Run AI function');
+  console.log('  npx cloud-pc-templates launch   Open website in browser');
   console.log('');
   console.log('AI Commands:');
   console.log('  npx cloud-pc-templates ai login loginMode ollamacloud');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloud-pc-templates",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "",
   "main": "index.js",
   "bin": {