claude-yolo-extended 1.8.0 → 1.8.2

package/CLAUDE.md

@@ -0,0 +1,76 @@
+# Claude YOLO Extended - Project Information
+
+This document contains important information about the Claude YOLO Extended project for AI assistants.
+
+## Project Overview
+
+Claude YOLO Extended is a wrapper for the Claude CLI that provides:
+- **YOLO Mode**: Bypasses safety checks (use with caution)
+- **SAFE Mode**: Standard Claude CLI behavior with all safety checks
+- **Cross-Platform Support**: Works on Windows, Ubuntu, and other Unix systems
+- **Auto-Update**: Automatically updates to the latest Claude CLI version
+
+## Installation Methods
+
+### From npm (Recommended for users)
+```bash
+npm install -g claude-yolo-extended
+```
+
+### From source (For development)
+```bash
+git clone https://github.com/jslitzkerttcu/claude-yolo.git
+cd claude-yolo
+npm install
+npm link
+```
+
+## Key Commands
+
+- `claude-yolo-extended` - Run in current mode (default: YOLO)
+- `claude-yolo-extended --safe` - Run in SAFE mode
+- `claude-yolo-extended mode yolo` - Switch to YOLO mode
+- `claude-yolo-extended mode safe` - Switch to SAFE mode
+- `cl /YON` - Enable YOLO mode and start Claude
+- `cl /YOFF` - Enable SAFE mode and start Claude
+
+## Development Workflow
+
+### Making Changes
+
+1. Make code changes
+2. Test locally with `npm link`
+3. Run `claude-yolo-extended --help` to verify
+
+### Publishing Updates
+
+1. Update version: `npm version patch|minor|major`
+2. Publish: `npm publish`
+3. Push to GitHub: `git push origin main --tags`
+
+### Version Strategy
+
+- **patch**: Bug fixes (1.8.0 -> 1.8.1)
+- **minor**: New features (1.8.0 -> 1.9.0)
+- **major**: Breaking changes (1.8.0 -> 2.0.0)
+
+## Important Files
+
+- `bin/claude-yolo.js` - Main wrapper script
+- `bin/cl` - Bash convenience wrapper
+- `bin/cl.ps1` - PowerShell convenience wrapper
+- `package.json` - Project configuration
+- `.npmignore` - Files excluded from npm package
+
+## Security Considerations
+
+- YOLO mode bypasses important safety checks
+- The tool modifies Claude CLI behavior at runtime
+- Consent is required on first run
+- Mode preference is stored in `~/.claude_yolo_state`
+
+## Project URLs
+
+- **npm Package**: https://www.npmjs.com/package/claude-yolo-extended
+- **GitHub Repository**: https://github.com/jslitzkerttcu/claude-yolo
+- **Issues**: https://github.com/jslitzkerttcu/claude-yolo/issues

package/README.md

@@ -16,10 +16,19 @@ A wrapper for the Claude CLI that can run in YOLO mode (bypassing all safety che
 
 ## Installation
 
+### Option 1: Install from npm (Recommended)
+
+```bash
+# Install globally from npm
+npm install -g claude-yolo-extended
+```
+
+### Option 2: Install from source
+
 ```bash
 # Clone the repository
-git clone https://github.com/jslitzkerttcu/claude-yolo-extended.git
-cd claude-yolo-extended
+git clone https://github.com/jslitzkerttcu/claude-yolo.git
+cd claude-yolo
 
 # Install dependencies
 npm install
@@ -175,4 +184,61 @@ This is an unofficial tool and not supported by Anthropic. Use at your own risk.
   - Running as root with bypassed permissions is extremely dangerous
   - You accept full responsibility for any security implications
   
-Anthropic designed these safety checks for good reason. Only use YOLO mode if you fully understand and accept these risks. Use SAFE mode when you want the standard Claude CLI protections.
+Anthropic designed these safety checks for good reason. Only use YOLO mode if you fully understand and accept these risks. Use SAFE mode when you want the standard Claude CLI protections.
+
+## Development & Contributing
+
+### Making Changes
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/jslitzkerttcu/claude-yolo.git
+   cd claude-yolo
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Link locally for testing:
+   ```bash
+   npm link
+   ```
+
+4. Test your changes:
+   ```bash
+   claude-yolo-extended --help
+   ```
+
+### Publishing Updates
+
+1. Make your changes and test thoroughly
+
+2. Update the version number:
+   ```bash
+   # For bug fixes (1.8.0 -> 1.8.1)
+   npm version patch
+   
+   # For new features (1.8.0 -> 1.9.0)
+   npm version minor
+   
+   # For breaking changes (1.8.0 -> 2.0.0)
+   npm version major
+   ```
+
+3. Publish to npm:
+   ```bash
+   npm publish
+   ```
+
+4. Push changes to GitHub:
+   ```bash
+   git push origin main --tags
+   ```
+
+### Version Guidelines
+
+- **Patch** (x.x.1): Bug fixes, typo corrections, small tweaks
+- **Minor** (x.1.0): New features, improvements that don't break existing functionality
+- **Major** (2.0.0): Breaking changes, major rewrites, incompatible API changes

package/bin/cl.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import { spawn } from 'child_process';
+import os from 'os';
+import { fileURLToPath } from 'url';
+
+// Get the directory of the current module
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// ANSI color codes
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+
+// State file path
+const stateFile = path.join(os.homedir(), '.claude_yolo_state');
+
+// Function to get current mode
+function getMode() {
+  try {
+    return fs.readFileSync(stateFile, 'utf8').trim();
+  } catch {
+    return 'YOLO'; // Default to YOLO mode (matches claude-yolo-extended behavior)
+  }
+}
+
+// Function to set mode
+function setMode(mode) {
+  fs.writeFileSync(stateFile, mode);
+}
+
+// Get command line arguments
+const args = process.argv.slice(2);
+
+// Handle special commands
+if (args.length > 0) {
+  const command = args[0].toUpperCase();
+  
+  switch (command) {
+    case '/YON':
+      console.log(`${YELLOW}${BOLD}🔥 ACTIVATING YOLO MODE 🔥${RESET}`);
+      console.log(`${RED}⚠️  WARNING: All safety checks will be DISABLED!${RESET}`);
+      console.log(`${RED}⚠️  Claude can access ANY file without asking!${RESET}`);
+      setMode('YOLO');
+      console.log(`${YELLOW}✓ YOLO mode is now ON${RESET}`);
+      
+      // Auto-start with remaining args
+      if (args.length > 1) {
+        runClaude(args.slice(1));
+      } else {
+        runClaude([]);
+      }
+      break;
+      
+    case '/YOFF':
+      console.log(`${CYAN}${BOLD}🛡️  ACTIVATING SAFE MODE 🛡️${RESET}`);
+      console.log(`${GREEN}✓ Safety checks will be enabled${RESET}`);
+      console.log(`${GREEN}✓ Claude will ask for permissions${RESET}`);
+      setMode('SAFE');
+      console.log(`${CYAN}✓ YOLO mode is now OFF (Safe mode ON)${RESET}`);
+      
+      // Auto-start with remaining args
+      if (args.length > 1) {
+        runClaude(args.slice(1));
+      } else {
+        runClaude([]);
+      }
+      break;
+      
+    case '/STATUS':
+      const mode = getMode();
+      console.log(`${BOLD}Claude CLI Status:${RESET}`);
+      console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+      if (mode === 'YOLO') {
+        console.log(`Mode: ${YELLOW}${BOLD}YOLO${RESET} 🔥`);
+        console.log(`Safety: ${RED}DISABLED${RESET}`);
+        console.log(`Permissions: ${RED}BYPASSED${RESET}`);
+      } else {
+        console.log(`Mode: ${CYAN}${BOLD}SAFE${RESET} 🛡️`);
+        console.log(`Safety: ${GREEN}ENABLED${RESET}`);
+        console.log(`Permissions: ${GREEN}REQUIRED${RESET}`);
+      }
+      console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+      break;
+      
+    case '/HELP':
+    case '/H':
+    case '/?':
+      console.log(`${BOLD}Claude CLI Wrapper - Help${RESET}`);
+      console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+      console.log(`${CYAN}cl /YON${RESET}     - Enable YOLO mode (bypass safety)`);
+      console.log(`${CYAN}cl /YOFF${RESET}    - Disable YOLO mode (safe mode)`);
+      console.log(`${CYAN}cl /STATUS${RESET}  - Show current mode`);
+      console.log(`${CYAN}cl /HELP${RESET}    - Show this help`);
+      console.log(`${CYAN}cl [args]${RESET}   - Run claude with current mode`);
+      console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+      console.log('');
+      console.log(`${BOLD}Examples:${RESET}`);
+      console.log('  cl /YON                    # Enable YOLO mode');
+      console.log('  cl /YOFF                   # Enable SAFE mode');
+      console.log('  cl "write a function"      # Run Claude in current mode');
+      console.log('');
+      console.log(`${BOLD}Mode Persistence:${RESET}`);
+      console.log('Your mode choice is saved in ~/.claude_yolo_state');
+      console.log('and persists between terminal sessions.');
+      break;
+      
+    default:
+      // Run Claude with provided arguments
+      runClaude(args);
+  }
+} else {
+  // No arguments, just run Claude
+  runClaude([]);
+}
+
+function runClaude(claudeArgs) {
+  const mode = getMode();
+  
+  // Show current mode
+  if (mode === 'YOLO') {
+    console.log(`${YELLOW}[YOLO]${RESET} Running Claude in YOLO mode...`);
+  } else {
+    console.log(`${CYAN}[SAFE]${RESET} Running Claude in SAFE mode...`);
+  }
+  
+  // Determine which command to run
+  const command = 'claude-yolo-extended';
+  const commandArgs = mode === 'SAFE' ? ['--safe', ...claudeArgs] : claudeArgs;
+  
+  // Spawn the process
+  const child = spawn(command, commandArgs, {
+    stdio: 'inherit',
+    shell: true
+  });
+  
+  child.on('error', (err) => {
+    console.error(`${RED}Error: Failed to start ${command}${RESET}`);
+    console.error(err.message);
+    process.exit(1);
+  });
+  
+  child.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+}

package/package.json

@@ -1,19 +1,16 @@
 {
   "name": "claude-yolo-extended",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "Claude CLI wrapper with YOLO mode (bypass safety) and SAFE mode support, auto-updates, and colorful loading messages",
   "bin": {
     "claude-yolo-extended": "bin/claude-yolo.js",
-    "cl": "bin/cl"
+    "cl": "bin/cl.js"
   },
   "dependencies": {
     "punycode": "latest",
     "@anthropic-ai/claude-code": "1.0.53"
   },
   "type": "module",
-  "scripts": {
-    "postinstall": "node -e \"require('fs').chmodSync('./bin/cl', 0o755);\""
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jslitzkerttcu/claude-yolo.git"