@amirdaraee/namewise 0.3.1 → 0.4.0

package/.github/workflows/build.yml

@@ -0,0 +1,49 @@
+name: Build Pipeline
+
+on:
+  workflow_dispatch: # Allows manual triggering
+  push:
+    branches: [ main ]
+  workflow_call: # Allows this workflow to be called by other workflows
+
+jobs:
+  build:
+    name: Build Project
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Build project
+        run: npm run build
+      
+      - name: Test CLI build
+        run: |
+          node dist/index.js --help
+          node dist/index.js --version
+      
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-artifacts-${{ github.sha }}
+          path: |
+            dist/
+            package.json
+            package-lock.json
+            README.md
+            LICENSE
+            CHANGELOG.md
+          retention-days: 30
+          
+      - name: Build success notification
+        run: echo "✅ Build completed successfully for commit ${{ github.sha }}"

package/.github/workflows/publish.yml

@@ -1,43 +1,86 @@
-name: Publish Package
+name: Publish Pipeline
 
 on:
+  workflow_dispatch: # Allows manual triggering
   release:
-    types: [created]
+    types: [published]
 
 jobs:
-  publish-npm:
+  publish:
+    name: Publish Package
     runs-on: ubuntu-latest
+    environment: production # Requires environment approval for production
+    
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
           node-version: '22'
-          registry-url: https://registry.npmjs.org/
-      - run: npm ci
-      - run: npm run build
-      - run: npm run test:run
-      - run: npm publish
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Run tests
+        run: npm run test:run
+      
+      - name: Build project
+        run: npm run build
+      
+      - name: Publish to NPM
+        run: npm publish
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      
+      - name: Publish success notification
+        run: echo "✅ Package published to NPM successfully"
 
-  publish-gpr:
+  publish-github:
+    name: Publish to GitHub Packages
     runs-on: ubuntu-latest
+    needs: publish
     permissions:
       contents: read
       packages: write
+    
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
           node-version: '22'
-          registry-url: https://npm.pkg.github.com/
-      - run: npm ci
-      - run: npm run build
-      - run: npm run test:run
-      - name: Publish to GitHub Packages
+          registry-url: 'https://npm.pkg.github.com'
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Build project
+        run: npm run build
+      
+      - name: Configure package for GitHub Packages
         run: |
-          echo "registry=https://npm.pkg.github.com/" > .npmrc
-          echo "//npm.pkg.github.com/:_authToken=${{ secrets.GITHUB_TOKEN }}" >> .npmrc
-          npm publish
+          cp package.json package.json.backup
+          node -e "
+            const pkg = require('./package.json');
+            pkg.name = '@${{ github.repository_owner }}/' + pkg.name.split('/').pop();
+            require('fs').writeFileSync('package.json', JSON.stringify(pkg, null, 2));
+          "
+      
+      - name: Publish to GitHub Packages
+        run: npm publish
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Restore original package.json
+        run: mv package.json.backup package.json
+        if: always()
+      
+      - name: GitHub Packages success notification
+        run: echo "✅ Package published to GitHub Packages successfully"

package/.github/workflows/test.yml

@@ -1,21 +1,24 @@
-name: Test
+name: Test Pipeline
 
 on:
+  workflow_dispatch: # Allows manual triggering
   push:
-    branches: [ main ]
+    branches: [ main, develop ]
   pull_request:
     branches: [ main ]
 
 jobs:
   test:
+    name: Run Tests
     runs-on: ubuntu-latest
     
     strategy:
       matrix:
         node-version: [18, 20, 22]
-
+    
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout code
+        uses: actions/checkout@v4
       
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
@@ -26,12 +29,18 @@ jobs:
       - name: Install dependencies
         run: npm ci
       
-      - name: Build project
-        run: npm run build
+      - name: Run linter (if available)
+        run: npm run lint --if-present
       
       - name: Run tests
         run: npm run test:run
       
-      - name: Run coverage
+      - name: Generate coverage report
         run: npm run test:coverage
-        if: matrix.node-version == '22'
+        if: matrix.node-version == '22'
+      
+      - name: Upload coverage reports
+        uses: codecov/codecov-action@v3
+        if: matrix.node-version == '22'
+        with:
+          fail_ci_if_error: false

package/README.md

@@ -8,13 +8,15 @@
 
 🤖 **AI-Powered File Renaming CLI Tool**
 
-Automatically rename files based on their content using Claude or OpenAI. Transform messy filenames like `document1.pdf` or `IMG_20240315_143022.pdf` into descriptive names like `project-requirements-document.pdf` or `quarterly-sales-report-q4-2023.pdf`.
+Automatically rename files based on their content using AI providers (Claude, OpenAI, Ollama, LMStudio). Transform messy filenames like `document1.pdf` or `IMG_20240315_143022.pdf` into descriptive names like `project-requirements-document.pdf` or `quarterly-sales-report-q4-2023.pdf`.
 
 > **Perfect for**: Document management, file organization, bulk renaming based on content analysis
 
 ## Features
 
-- **AI-Powered Renaming**: Uses Claude or OpenAI to generate descriptive filenames based on document content
+- **AI-Powered Renaming**: Uses cloud providers (Claude, OpenAI) or local LLMs (Ollama, LMStudio) to generate descriptive filenames
+- **Privacy First**: Local LLM support means your files never leave your machine
+- **Cost Effective**: Use free local models or pay-per-use cloud APIs
 - **Personal File Templates**: Customizable templates for different file categories (documents, movies, music, series, photos, books)
 - **Smart Categorization**: Automatic file type detection or manual category selection
 - **Naming Convention Options**: 6 different formats (kebab-case, snake_case, camelCase, PascalCase, lowercase, UPPERCASE)
@@ -63,7 +65,9 @@ namewise rename <directory> [options]
 ### Options Reference
 | Option | Description | Default |
 |--------|-------------|---------|
-| `--provider` | AI provider (`claude` or `openai`) | `claude` |
+| `--provider` | AI provider (`claude`, `openai`, `ollama`, `lmstudio`) | `claude` |
+| `--base-url` | Base URL for local LLM providers | Auto-detected |
+| `--model` | Model name for local LLM providers | Provider default |
 | `--api-key` | API key for the chosen provider | Interactive prompt |
 | `--case` | Naming convention (kebab-case, snake_case, camelCase, PascalCase, lowercase, UPPERCASE) | `kebab-case` |
 | `--template` | File category template (document, movie, music, series, photo, book, general, auto) | `general` |
@@ -110,6 +114,35 @@ namewise rename ./docs --case snake_case --dry-run
 # Result: project_requirements_document.pdf
 ```
 
+**Local LLMs (Privacy-First, No API Keys):**
+```bash
+# Ollama - requires 'ollama serve' running
+namewise rename ./documents --provider ollama --dry-run
+# Result: quarterly-financial-report.pdf
+
+# Custom Ollama model
+namewise rename ./code --provider ollama --model codellama --dry-run
+# Result: user-authentication-service.js
+
+# LMStudio - requires local server enabled
+namewise rename ./contracts --provider lmstudio --dry-run
+# Result: employment-agreement-template.docx
+
+# Remote Ollama server
+namewise rename ./files --provider ollama --base-url http://192.168.1.100:11434 --model llama3.1
+```
+
+**Cloud Providers (API Keys Required):**
+```bash
+# Claude (recommended for accuracy)
+export CLAUDE_API_KEY=your-key
+namewise rename ./documents --provider claude --dry-run
+
+# OpenAI  
+export OPENAI_API_KEY=your-key
+namewise rename ./files --provider openai --max-size 20 --dry-run
+```
+
 **Before and After Example:**
 ```
 📁 Before:
@@ -147,19 +180,54 @@ Choose from specialized templates for different file types:
 | `book` | `{author}-{content}` | `george-orwell-1984.pdf` | Books and ebooks |
 | `auto` | *Automatic* | *Varies by detected type* | Let AI detect and choose best template |
 
-## 🔑 API Keys Setup
+## 🔑 AI Provider Setup
+
+### 🏠 Local LLMs (Privacy-First, No API Keys)
 
-### Claude (Anthropic) - Recommended
+**Ollama** - Recommended for privacy
+1. Install: Download from [ollama.ai](https://ollama.ai)
+2. Start server: `ollama serve`
+3. Pull model: `ollama pull llama3.1` (or your preferred model)
+4. Use: `--provider ollama`
+
+**LMStudio** - User-friendly interface
+1. Install: Download from [lmstudio.ai](https://lmstudio.ai)
+2. Download and load a model in LMStudio
+3. Enable "Local Server" mode in LMStudio
+4. Use: `--provider lmstudio`
+
+### ☁️ Cloud Providers (Require API Keys)
+
+**Claude (Anthropic)** - Recommended for accuracy
 1. Visit [Anthropic Console](https://console.anthropic.com/)
 2. Create an account and generate an API key
 3. Set as environment variable: `export CLAUDE_API_KEY=your-key`
 
-### OpenAI
+**OpenAI**
 1. Visit [OpenAI Platform](https://platform.openai.com/api-keys)  
 2. Create an API key
 3. Set as environment variable: `export OPENAI_API_KEY=your-key`
 
-> 💡 **Tip**: The tool will prompt for API keys if not provided via command line or environment variables.
+### 🚀 Quick Start by Privacy Preference
+
+**Maximum Privacy (Local Processing):**
+```bash
+# Setup Ollama
+ollama serve
+ollama pull llama3.1
+
+# Use locally - no data leaves your machine
+namewise rename ./documents --provider ollama --dry-run
+```
+
+**Balanced (Cloud with API key):**
+```bash
+# Use Claude for best accuracy
+export CLAUDE_API_KEY=your-key
+namewise rename ./documents --provider claude --dry-run
+```
+
+> 💡 **Tip**: Local LLMs require no API keys and keep your data private. Cloud providers may offer better accuracy but require API keys and send data externally.
 
 ## ⚙️ How It Works
 
@@ -214,7 +282,9 @@ The project includes comprehensive tests with 65 test cases covering all functio
 
 - **Node.js**: 18.0.0 or higher
 - **TypeScript**: 5.0.0 or higher  
-- **API Key**: Claude (Anthropic) or OpenAI
+- **AI Provider**: Choose one:
+  - **Local**: Ollama or LMStudio (no API key needed)
+  - **Cloud**: Claude (Anthropic) or OpenAI API key
 
 ## 🐛 Troubleshooting
 
@@ -226,11 +296,17 @@ The project includes comprehensive tests with 65 test cases covering all functio
 - Check file is not corrupted
 - Try reducing max-size limit
 
-**API errors:**
+**API errors (Cloud providers):**
 - Verify API key is valid
 - Check internet connection
 - Ensure sufficient API credits
 
+**Local LLM connection errors:**
+- Ensure Ollama server is running (`ollama serve`)
+- Check LMStudio local server is enabled
+- Verify correct base URL and port
+- Confirm model is loaded/available
+
 **Permission errors:**
 - Check file permissions
 - Run with appropriate user privileges

package/RELEASE.md

@@ -0,0 +1,155 @@
+# Release Process Documentation
+
+This document explains how to release a new version of the Namewise CLI tool.
+
+## Quick Release Commands
+
+Based on your `package.json` scripts, you can use these commands for automated releases:
+
+```bash
+npm run release        # Patch version (1.0.0 → 1.0.1)
+npm run release:minor  # Minor version (1.0.0 → 1.1.0)
+npm run release:major  # Major version (1.0.0 → 2.0.0)
+```
+
+These commands will:
+1. Run tests and build
+2. Bump the version in `package.json`
+3. Trigger the auto-release workflow
+
+## Manual Release Process
+
+If you prefer to do it manually:
+
+### 1. Prepare the Release
+
+```bash
+# Ensure you're on main branch with latest changes
+git checkout main
+git pull origin main
+
+# Run tests and build to ensure everything works
+npm run test:run
+npm run build
+```
+
+### 2. Update Version
+
+Choose the appropriate version bump:
+- **Patch** (bug fixes): `1.0.0 → 1.0.1`
+- **Minor** (new features): `1.0.0 → 1.1.0`
+- **Major** (breaking changes): `1.0.0 → 2.0.0`
+
+```bash
+# Update version in package.json
+npm version patch   # or minor, or major
+```
+
+### 3. Push Changes
+
+```bash
+# Push the version bump commit
+git push origin main
+```
+
+This will trigger the `auto-release.yml` workflow which will:
+- Create a Git tag
+- Publish to NPM automatically
+
+### 4. Create GitHub Release (Optional)
+
+To also publish to GitHub Packages:
+
+1. Go to your GitHub repository
+2. Click "Releases" → "Create a new release"
+3. Choose the tag that was just created (e.g., `v1.0.1`)
+4. Add release notes
+5. Click "Publish release"
+
+This triggers the `publish.yml` workflow.
+
+## GitHub Workflows
+
+Your project has three separate, independently runnable workflows:
+
+### 1. Test Pipeline (`test.yml`)
+- **Triggers**: Push to main/develop, PRs, manual dispatch
+- **Purpose**: Run tests and linting across Node.js versions
+- **Manual run**: Go to Actions → Test Pipeline → "Run workflow"
+
+### 2. Build Pipeline (`build.yml`)
+- **Triggers**: Push to main, manual dispatch, or called by other workflows
+- **Purpose**: Build the project and create artifacts
+- **Manual run**: Go to Actions → Build Pipeline → "Run workflow"
+
+### 3. Publish Pipeline (`publish.yml`)
+- **Triggers**: GitHub releases, manual dispatch
+- **Purpose**: Publish to NPM and GitHub Packages
+- **Manual run**: Go to Actions → Publish Pipeline → "Run workflow"
+
+### 4. Auto Release (`auto-release.yml`)
+- **Triggers**: Push to main when package.json version changes
+- **Purpose**: Automatically create tags and publish when version is bumped
+
+## Prerequisites
+
+### NPM Token
+Add `NPM_TOKEN` to your GitHub repository secrets:
+1. Go to npmjs.com → Access Tokens → Generate New Token
+2. Copy the token
+3. In GitHub: Settings → Secrets → Actions → New repository secret
+4. Name: `NPM_TOKEN`, Value: your token
+
+### Production Environment (Optional)
+For extra safety, create a production environment:
+1. GitHub → Settings → Environments → New environment
+2. Name: `production`
+3. Add protection rules (require reviews, etc.)
+
+## Version Strategy
+
+Follow [Semantic Versioning](https://semver.org/):
+
+- **Major** (`X.0.0`): Breaking changes that require user action
+- **Minor** (`0.X.0`): New features that are backward compatible
+- **Patch** (`0.0.X`): Bug fixes and small improvements
+
+## Troubleshooting
+
+### Release Failed
+- Check the Actions tab for error details
+- Ensure NPM_TOKEN is valid
+- Verify package.json version was actually changed
+- Make sure tests pass: `npm run test:run`
+
+### Package Already Published
+- NPM doesn't allow republishing the same version
+- Bump the version: `npm version patch`
+- Push: `git push origin main`
+
+### Manual Publishing
+If workflows fail, you can publish manually:
+```bash
+npm run build
+npm run test:run
+npm publish
+```
+
+## Example Release Workflow
+
+Here's a complete example of releasing version 1.2.3:
+
+```bash
+# 1. Prepare
+git checkout main
+git pull origin main
+npm run test:run
+
+# 2. Release (this does everything)
+npm run release:minor  # 1.2.2 → 1.2.3
+
+# 3. Create GitHub release (optional)
+# Go to GitHub → Releases → Create release from v1.2.3 tag
+```
+
+That's it! The automation handles the rest.

package/dist/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgBpD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqDpD"}

package/dist/cli/commands.js

@@ -2,16 +2,53 @@ import { renameFiles } from './rename.js';
 export function setupCommands(program) {
     program
         .command('rename')
-        .description('Rename files in a directory based on their content')
+        .description('🚀 Rename files in a directory based on their content using AI analysis')
         .argument('<directory>', 'Directory containing files to rename')
-        .option('-p, --provider <provider>', 'AI provider (claude|openai)', 'claude')
-        .option('-k, --api-key <key>', 'API key for the AI provider')
+        .option('-p, --provider <provider>', 'AI provider (claude|openai|ollama|lmstudio)', 'claude')
+        .option('-k, --api-key <key>', 'API key for cloud providers (or set CLAUDE_API_KEY/OPENAI_API_KEY)')
         .option('-c, --case <convention>', 'Naming convention (kebab-case|snake_case|camelCase|PascalCase|lowercase|UPPERCASE)', 'kebab-case')
         .option('-t, --template <category>', 'File category template (document|movie|music|series|photo|book|general|auto)', 'general')
-        .option('-n, --name <personalName>', 'Personal name to include in filenames')
-        .option('-d, --date <format>', 'Date format (YYYY-MM-DD|YYYY|YYYYMMDD|none)', 'none')
-        .option('--dry-run', 'Preview changes without renaming files', false)
-        .option('--max-size <size>', 'Maximum file size in MB', '10')
+        .option('-n, --name <personalName>', 'Personal name to include in filenames (for document/photo templates)')
+        .option('-d, --date <format>', 'Date format to include (YYYY-MM-DD|YYYY|YYYYMMDD|none)', 'none')
+        .option('--dry-run', 'Preview changes without actually renaming files (RECOMMENDED first!)', false)
+        .option('--max-size <size>', 'Maximum file size in MB to process', '10')
+        .option('--base-url <url>', 'Base URL for local LLM providers (default: ollama=http://localhost:11434, lmstudio=http://localhost:1234)')
+        .option('--model <name>', 'Model name for local LLM providers (default: ollama=llama3.1, lmstudio=local-model)')
+        .addHelpText('after', `
+
+🔍 How it works:
+  1. Scans directory for supported files (PDF, DOCX, XLSX, TXT, MD, RTF)
+  2. Extracts content and metadata from each file
+  3. Uses AI to analyze content and generate descriptive names
+  4. Applies your chosen template and naming convention
+  5. Renames files (or shows preview with --dry-run)
+
+💡 Pro Tips:
+  • Always use --dry-run first to preview changes
+  • Use 'auto' template for smart file type detection
+  • Personal templates work great for documents and photos
+  • Set API keys as environment variables for cloud providers
+  • Local LLMs (Ollama/LMStudio) require running servers first
+
+🖥️  Local LLM Setup:
+  • Ollama: Start with 'ollama serve' (default: http://localhost:11434)
+  • LMStudio: Enable local server mode (default: http://localhost:1234)
+
+📝 Examples:
+  # Safe preview first
+  namewise rename ./documents --dry-run
+
+  # Cloud providers (require API keys)
+  namewise rename ./docs --provider claude --template document --name "alice"
+  namewise rename ./media --provider openai --template auto
+
+  # Local LLMs (no API key needed)
+  namewise rename ./documents --provider ollama --model llama3.1 --dry-run
+  namewise rename ./contracts --provider lmstudio --base-url http://localhost:1234
+  
+  # Custom Ollama setup
+  namewise rename ./files --provider ollama --base-url http://192.168.1.100:11434 --model codellama
+`)
         .action(async (directory, options) => {
         await renameFiles(directory, options);
     });

package/dist/cli/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oDAAoD,CAAC;SACjE,QAAQ,CAAC,aAAa,EAAE,sCAAsC,CAAC;SAC/D,MAAM,CAAC,2BAA2B,EAAE,6BAA6B,EAAE,QAAQ,CAAC;SAC5E,MAAM,CAAC,qBAAqB,EAAE,6BAA6B,CAAC;SAC5D,MAAM,CAAC,yBAAyB,EAAE,oFAAoF,EAAE,YAAY,CAAC;SACrI,MAAM,CAAC,2BAA2B,EAAE,8EAA8E,EAAE,SAAS,CAAC;SAC9H,MAAM,CAAC,2BAA2B,EAAE,uCAAuC,CAAC;SAC5E,MAAM,CAAC,qBAAqB,EAAE,6CAA6C,EAAE,MAAM,CAAC;SACpF,MAAM,CAAC,WAAW,EAAE,wCAAwC,EAAE,KAAK,CAAC;SACpE,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,EAAE,IAAI,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;QACnC,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,yEAAyE,CAAC;SACtF,QAAQ,CAAC,aAAa,EAAE,sCAAsC,CAAC;SAC/D,MAAM,CAAC,2BAA2B,EAAE,6CAA6C,EAAE,QAAQ,CAAC;SAC5F,MAAM,CAAC,qBAAqB,EAAE,oEAAoE,CAAC;SACnG,MAAM,CAAC,yBAAyB,EAAE,oFAAoF,EAAE,YAAY,CAAC;SACrI,MAAM,CAAC,2BAA2B,EAAE,8EAA8E,EAAE,SAAS,CAAC;SAC9H,MAAM,CAAC,2BAA2B,EAAE,sEAAsE,CAAC;SAC3G,MAAM,CAAC,qBAAqB,EAAE,wDAAwD,EAAE,MAAM,CAAC;SAC/F,MAAM,CAAC,WAAW,EAAE,sEAAsE,EAAE,KAAK,CAAC;SAClG,MAAM,CAAC,mBAAmB,EAAE,oCAAoC,EAAE,IAAI,CAAC;SACvE,MAAM,CAAC,kBAAkB,EAAE,2GAA2G,CAAC;SACvI,MAAM,CAAC,gBAAgB,EAAE,qFAAqF,CAAC;SAC/G,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCzB,CAAC;SACG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;QACnC,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/rename.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../src/cli/rename.ts"],"names":[],"mappings":"AAQA,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAiFhF"}
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../src/cli/rename.ts"],"names":[],"mappings":"AAQA,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CA+FhF"}

package/dist/cli/rename.js

@@ -11,18 +11,28 @@ export async function renameFiles(directory, options) {
         if (!stats.isDirectory()) {
             throw new Error(`${directory} is not a directory`);
         }
-        // Get API key
+        // Get API key for cloud providers only
         let apiKey = options.apiKey;
-        if (!apiKey) {
-            const keyPrompt = await inquirer.prompt([
-                {
-                    type: 'password',
-                    name: 'apiKey',
-                    message: `Enter your ${options.provider} API key:`,
-                    mask: '*'
-                }
-            ]);
-            apiKey = keyPrompt.apiKey;
+        const requiresApiKey = ['claude', 'openai'].includes(options.provider);
+        if (requiresApiKey && !apiKey) {
+            // Check environment variables first
+            if (options.provider === 'claude' && process.env.CLAUDE_API_KEY) {
+                apiKey = process.env.CLAUDE_API_KEY;
+            }
+            else if (options.provider === 'openai' && process.env.OPENAI_API_KEY) {
+                apiKey = process.env.OPENAI_API_KEY;
+            }
+            else {
+                const keyPrompt = await inquirer.prompt([
+                    {
+                        type: 'password',
+                        name: 'apiKey',
+                        message: `Enter your ${options.provider} API key:`,
+                        mask: '*'
+                    }
+                ]);
+                apiKey = keyPrompt.apiKey;
+            }
         }
         // Create config
         const config = {
@@ -36,11 +46,16 @@ export async function renameFiles(directory, options) {
                 category: options.template,
                 personalName: options.name,
                 dateFormat: options.date
+            },
+            // Local LLM specific configuration
+            localLLMConfig: {
+                baseUrl: options.baseUrl,
+                model: options.model
             }
         };
         // Initialize services
         const parserFactory = new DocumentParserFactory();
-        const aiService = AIServiceFactory.create(config.aiProvider, apiKey);
+        const aiService = AIServiceFactory.create(config.aiProvider, apiKey, config.localLLMConfig);
         const fileRenamer = new FileRenamer(parserFactory, aiService, config);
         // Get files to process
         const files = await getFilesToProcess(directory, config.supportedExtensions);