loren-code 0.1.4 → 0.2.0

package/README.md

@@ -20,7 +20,13 @@ loren help
 
 ## First Run
 
-Loren creates `.env.local` automatically if it does not exist.
+Loren stores user config in `%USERPROFILE%\.lorencode`.
+
+On first run it creates:
+
+```text
+C:\Users\<you>\.lorencode\.env.local
+```
 
 You must add valid `OLLAMA_API_KEYS` before the bridge can make upstream requests.
 If you configure multiple keys, Loren rotates them automatically.
@@ -107,11 +113,11 @@ npm.cmd install -g loren-code
 
 ### Missing API keys
 
-Populate `OLLAMA_API_KEYS` in `.env.local`.
+Populate `OLLAMA_API_KEYS` in `%USERPROFILE%\.lorencode\.env.local`.
 
 ### Port already in use
 
-Change `BRIDGE_PORT` in `.env.local`.
+Change `BRIDGE_PORT` in `%USERPROFILE%\.lorencode\.env.local`.
 
 ## Repository
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loren-code",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Ollama Cloud Model Manager - Dynamic model switching, API key rotation, and real-time configuration updates",
   "author": "lorenzune",
   "license": "MIT",
@@ -33,6 +33,7 @@
     "scripts/claude-wrapper.js",
     "scripts/install-claude-ollama.ps1",
     "scripts/loren.js",
+    "scripts/postinstall.js",
     "scripts/uninstall-claude-ollama.ps1",
     "src/*.js",
     ".env.example",
@@ -57,6 +58,7 @@
     "check:publish": "node scripts/publish-check.js",
     "prepack": "node scripts/sync-readme.js npm",
     "postpack": "node scripts/sync-readme.js github",
+    "postinstall": "node scripts/postinstall.js",
     "prepublishOnly": "npm test && npm run lint",
     "test": "node scripts/publish-check.js",
     "lint": "node -e \"console.log('No linter configured')\""

package/scripts/claude-wrapper.js

@@ -5,18 +5,19 @@ import process from "node:process";
 import { fileURLToPath } from "node:url";
 import { ensureEnvLocal, ensureRuntimeDir, getBridgeBaseUrl } from "../src/bootstrap.js";
 import { loadConfig } from "../src/config.js";
+import { getEnvFilePath, getRuntimeDir } from "../src/paths.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const repoRoot = path.resolve(__dirname, "..");
-const stateDir = path.join(repoRoot, ".runtime");
+const stateDir = getRuntimeDir();
 const bridgePidPath = path.join(stateDir, "bridge.pid");
 const bridgeLogPath = path.join(stateDir, "bridge.log");
-const envFilePath = path.join(repoRoot, ".env.local");
+const envFilePath = getEnvFilePath();
 
 async function main() {
   process.chdir(repoRoot);
-  ensureRuntimeDir(repoRoot);
+  ensureRuntimeDir();
   ensureEnvLocal(repoRoot);
   const bridgeConfig = loadConfig();
   const bridgeBaseUrl = getBridgeBaseUrl(bridgeConfig);

package/scripts/install-claude-ollama.ps1

@@ -3,13 +3,16 @@ $ErrorActionPreference = "Stop"
 $repoRoot = Split-Path -Parent $PSScriptRoot
 $userProfile = [Environment]::GetFolderPath("UserProfile")
 $appData = [Environment]::GetFolderPath("ApplicationData")
+$lorenHome = if ($env:LOREN_HOME) { $env:LOREN_HOME } else { Join-Path $userProfile ".lorencode" }
 $workspaceSettingsDir = Join-Path $appData "Code\\User"
 $workspaceSettingsPath = Join-Path $workspaceSettingsDir "settings.json"
 $claudeDir = Join-Path $userProfile ".claude"
 $claudeSettingsPath = Join-Path $claudeDir "settings.json"
 $launcherSourcePath = Join-Path $repoRoot "scripts\\ClaudeWrapperLauncher.cs"
 $launcherExePath = Join-Path $repoRoot "scripts\\ClaudeWrapperLauncher.exe"
-$envPath = Join-Path $repoRoot ".env.local"
+$envTemplatePath = Join-Path $repoRoot ".env.example"
+$legacyEnvPath = Join-Path $repoRoot ".env.local"
+$envPath = Join-Path $lorenHome ".env.local"
 $npmBinDir = Join-Path $appData "npm"
 $claudeCmdPath = Join-Path $npmBinDir "claude.cmd"
 $claudeShellPath = Join-Path $npmBinDir "claude"
@@ -18,14 +21,21 @@ $claudeCmdBackupPath = Join-Path $npmBinDir "claude.loren-backup.cmd"
 $claudeShellBackupPath = Join-Path $npmBinDir "claude.loren-backup"
 $claudePs1BackupPath = Join-Path $npmBinDir "claude.loren-backup.ps1"
 
-if (-not (Test-Path $envPath)) {
-  throw ".env.local not found. Create it first with OLLAMA_API_KEYS."
-}
-
 New-Item -ItemType Directory -Force -Path $workspaceSettingsDir | Out-Null
 New-Item -ItemType Directory -Force -Path $claudeDir | Out-Null
+New-Item -ItemType Directory -Force -Path $lorenHome | Out-Null
 New-Item -ItemType Directory -Force -Path $npmBinDir | Out-Null
 
+if (-not (Test-Path $envPath)) {
+  if (Test-Path $legacyEnvPath) {
+    Copy-Item -LiteralPath $legacyEnvPath -Destination $envPath -Force
+  } elseif (Test-Path $envTemplatePath) {
+    Copy-Item -LiteralPath $envTemplatePath -Destination $envPath -Force
+  } else {
+    Set-Content -LiteralPath $envPath -Value "OLLAMA_API_KEYS=`nBRIDGE_HOST=127.0.0.1`nBRIDGE_PORT=8788`n" -Encoding UTF8
+  }
+}
+
 function Read-JsonFile {
   param([string]$Path)
 
@@ -197,6 +207,10 @@ $bridgeBaseUrl = "http://${bridgeHost}:${bridgePort}"
 $workspaceSettings["claudeCode.claudeProcessWrapper"] = $launcherExePath
 $workspaceSettings["claudeCode.disableLoginPrompt"] = $true
 $workspaceSettings["claudeCode.environmentVariables"] = @(
+  @{
+    name = "LOREN_HOME"
+    value = $lorenHome
+  },
   @{
     name = "ANTHROPIC_BASE_URL"
     value = $bridgeBaseUrl
@@ -233,7 +247,17 @@ if ($availableModels.Count -eq 0) {
   throw "OLLAMA_MODEL_ALIASES does not contain any models"
 }
 
-$defaultModel = if ($aliases.ContainsKey("ollama-free-auto")) { "ollama-free-auto" } else { $availableModels[0] }
+$configuredDefaultModel = Get-EnvValue -Path $envPath -Name "DEFAULT_MODEL_ALIAS"
+if (
+  -not [string]::IsNullOrWhiteSpace($configuredDefaultModel) -and
+  $availableModels.Contains($configuredDefaultModel)
+) {
+  $defaultModel = $configuredDefaultModel
+} elseif ($aliases.ContainsKey("ollama-free-auto")) {
+  $defaultModel = "ollama-free-auto"
+} else {
+  $defaultModel = $availableModels[0]
+}
 $claudeSettings["model"] = $defaultModel
 $claudeSettings["availableModels"] = $availableModels
 Write-JsonFile -Path $claudeSettingsPath -Data $claudeSettings
@@ -261,9 +285,11 @@ $ps1Content = @"
 Set-Content -LiteralPath $claudePs1Path -Value $ps1Content -Encoding UTF8
 
 Write-Host "Installation completed."
+Write-Host "Loren home:" $lorenHome
 Write-Host "Claude launcher:" $launcherExePath
 Write-Host "VS Code user settings:" $workspaceSettingsPath
 Write-Host "Claude user settings:" $claudeSettingsPath
+Write-Host "Loren config:" $envPath
 Write-Host "Global Claude command:" $claudeCmdPath
 Write-Host ""
 Write-Host "Restart VS Code. Claude Code will use the bridge in any project."

package/scripts/loren.js

@@ -5,11 +5,13 @@ import { execFileSync, spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { loadConfig, loadEnvFile, saveEnvFile } from "../src/config.js";
 import { ensureEnvLocal, ensureRuntimeDir, getBridgeBaseUrl } from "../src/bootstrap.js";
+import { getEnvFilePath, getLorenHome, getRuntimeDir } from "../src/paths.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const projectRoot = path.resolve(__dirname, "..");
-const envFilePath = path.join(projectRoot, ".env.local");
-const runtimeDir = path.join(projectRoot, ".runtime");
+const lorenHome = getLorenHome();
+const envFilePath = getEnvFilePath();
+const runtimeDir = getRuntimeDir();
 const pidFilePath = path.join(runtimeDir, "loren.pid");
 const logFilePath = path.join(runtimeDir, "bridge.log");
 const errorLogFilePath = path.join(runtimeDir, "bridge.err.log");
@@ -18,8 +20,8 @@ const claudeSettingsPath = path.join(userHome, ".claude", "settings.json");
 
 // Force working directory to project root for config loading
 process.chdir(projectRoot);
-ensureRuntimeDir(projectRoot);
-ensureEnvLocal(projectRoot);
+const runtimePath = ensureRuntimeDir();
+const envStatus = ensureEnvLocal(projectRoot);
 
 const ASCII_LOGO = `
 ██╗      ██████╗ ██████╗ ███████╗███╗   ██╗     ██████╗ ██████╗ ██████╗ ███████╗
@@ -56,9 +58,11 @@ const COMMANDS = {
 function main() {
   const args = process.argv.slice(2);
   const [command] = args;
+  const config = loadConfig();
 
   if (!command || command === "help" || command === "--help" || command === "-h") {
     printHelp();
+    maybePrintSetupHint(config);
     process.exit(0);
   }
 
@@ -336,6 +340,9 @@ function showConfig() {
 
   console.log("\nCurrent Configuration:");
   console.log("─".repeat(40));
+  console.log(`  Home:        ${lorenHome}`);
+  console.log(`  Env File:    ${envFilePath}`);
+  console.log(`  Runtime:     ${runtimePath}`);
   console.log(`  Host:        ${config.host}`);
   console.log(`  Port:        ${config.port}`);
   console.log(`  Upstream:    ${config.upstreamBaseUrl}`);
@@ -497,6 +504,29 @@ function syncClaudeSelectedModel(model) {
   fs.writeFileSync(claudeSettingsPath, `${JSON.stringify(settings, null, 2)}\n`, "utf8");
 }
 
+function maybePrintSetupHint(config) {
+  if (!envStatus.created && config.apiKeys.length > 0) {
+    return;
+  }
+
+  console.log("Setup:");
+  console.log(`  Loren home: ${lorenHome}`);
+  console.log(`  Config file: ${envFilePath}`);
+
+  if (envStatus.migrated) {
+    console.log("  Existing configuration was migrated automatically.");
+  } else if (envStatus.created) {
+    console.log("  A new config file was created automatically.");
+  }
+
+  if (config.apiKeys.length === 0) {
+    console.log("  Add OLLAMA_API_KEYS to finish setup.");
+  }
+
+  console.log("  Then run: loren start");
+  console.log("");
+}
+
 // ============== HELP ==============
 
 function printHelp() {

package/scripts/postinstall.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { getEnvFilePath, getLorenHome } from "../src/paths.js";
+
+console.log("");
+console.log("Loren Code installed.");
+console.log(`Loren home: ${getLorenHome()}`);
+console.log(`Config file: ${getEnvFilePath()}`);
+console.log("");
+console.log("Next steps:");
+console.log("  1. Run: loren");
+console.log("  2. Add your OLLAMA_API_KEYS");
+console.log("  3. Start the bridge with: loren start");
+console.log("");
+console.log("Optional Windows Claude integration:");
+console.log("  powershell -ExecutionPolicy Bypass -File \"$(npm prefix -g)\\node_modules\\loren-code\\scripts\\install-claude-ollama.ps1\"");
+console.log("");

package/scripts/uninstall-claude-ollama.ps1

@@ -3,9 +3,10 @@ $ErrorActionPreference = "Stop"
 $repoRoot = Split-Path -Parent $PSScriptRoot
 $userProfile = [Environment]::GetFolderPath("UserProfile")
 $appData = [Environment]::GetFolderPath("ApplicationData")
+$lorenHome = if ($env:LOREN_HOME) { $env:LOREN_HOME } else { Join-Path $userProfile ".lorencode" }
 $workspaceSettingsPath = Join-Path $appData "Code\\User\\settings.json"
 $claudeSettingsPath = Join-Path $userProfile ".claude\\settings.json"
-$bridgePidPath = Join-Path $repoRoot ".runtime\\bridge.pid"
+$bridgePidPath = Join-Path $lorenHome "runtime\\bridge.pid"
 $launcherExePath = Join-Path $repoRoot "scripts\\ClaudeWrapperLauncher.exe"
 $npmBinDir = Join-Path $appData "npm"
 $claudeCmdPath = Join-Path $npmBinDir "claude.cmd"

package/src/bootstrap.js

@@ -1,19 +1,30 @@
 import fs from "node:fs";
 import path from "node:path";
+import { getEnvFilePath, getLegacyEnvFilePath, getLorenHome, getRuntimeDir } from "./paths.js";
 
-export function ensureRuntimeDir(projectRoot) {
-  fs.mkdirSync(path.join(projectRoot, ".runtime"), { recursive: true });
+export function ensureRuntimeDir() {
+  fs.mkdirSync(getLorenHome(), { recursive: true });
+  fs.mkdirSync(getRuntimeDir(), { recursive: true });
+  return getRuntimeDir();
 }
 
 export function ensureEnvLocal(projectRoot, options = {}) {
-  const envLocalPath = path.join(projectRoot, ".env.local");
+  const envLocalPath = getEnvFilePath();
+  const legacyEnvPath = getLegacyEnvFilePath(projectRoot);
   const envExamplePath = path.join(projectRoot, ".env.example");
   const logger = options.logger ?? console;
+  fs.mkdirSync(getLorenHome(), { recursive: true });
 
   if (fs.existsSync(envLocalPath)) {
     return { created: false, path: envLocalPath };
   }
 
+  if (fs.existsSync(legacyEnvPath) && legacyEnvPath !== envLocalPath) {
+    fs.copyFileSync(legacyEnvPath, envLocalPath);
+    logger.warn?.(`Migrated existing config from ${legacyEnvPath} to ${envLocalPath}.`);
+    return { created: true, migrated: true, path: envLocalPath };
+  }
+
   if (!fs.existsSync(envExamplePath)) {
     fs.writeFileSync(envLocalPath, "OLLAMA_API_KEYS=\nBRIDGE_HOST=127.0.0.1\nBRIDGE_PORT=8788\n", "utf8");
     logger.warn?.(`Created ${envLocalPath}. Add your Ollama API key(s) before starting the bridge.`);

package/src/config.js

@@ -1,11 +1,11 @@
 import fs from "node:fs";
-import path from "node:path";
+import { getEnvFilePath } from "./paths.js";
 
 const DEFAULT_PORT = 8788;
 const DEFAULT_HOST = "127.0.0.1";
 const DEFAULT_UPSTREAM = "https://ollama.com";
 
-export function loadEnvFile(filePath = path.join(process.cwd(), ".env.local")) {
+export function loadEnvFile(filePath = getEnvFilePath()) {
   if (!fs.existsSync(filePath)) {
     return {};
   }
@@ -68,8 +68,8 @@ export function saveEnvFile(filePath, envVars) {
   fs.writeFileSync(filePath, `${lines}\n`, "utf8");
 }
 
-export function loadConfig() {
-  const fileEnv = loadEnvFile();
+export function loadConfig(filePath = getEnvFilePath()) {
+  const fileEnv = loadEnvFile(filePath);
   const getValue = (name, fallback = undefined) => {
     if (Object.prototype.hasOwnProperty.call(fileEnv, name)) {
       return fileEnv[name];

package/src/logger.js

@@ -1,9 +1,10 @@
 import winston from 'winston';
+import fs from 'node:fs';
 import path from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { getRuntimeDir } from './paths.js';
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
+const runtimeDir = getRuntimeDir();
+fs.mkdirSync(runtimeDir, { recursive: true });
 
 const logFormat = winston.format.combine(
   winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
@@ -24,23 +25,23 @@ const logger = winston.createLogger({
       )
     }),
     new winston.transports.File({
-      filename: path.join(__dirname, '..', '.runtime', 'error.log'),
+      filename: path.join(runtimeDir, 'error.log'),
       level: 'error',
       maxsize: 5242880, // 5MB
       maxFiles: 5
     }),
     new winston.transports.File({
-      filename: path.join(__dirname, '..', '.runtime', 'combined.log'),
+      filename: path.join(runtimeDir, 'combined.log'),
       maxsize: 5242880, // 5MB
       maxFiles: 5
     })
   ],
   exceptionHandlers: [
-    new winston.transports.File({ filename: path.join(__dirname, '..', '.runtime', 'exceptions.log') })
+    new winston.transports.File({ filename: path.join(runtimeDir, 'exceptions.log') })
   ],
   rejectionHandlers: [
-    new winston.transports.File({ filename: path.join(__dirname, '..', '.runtime', 'rejections.log') })
+    new winston.transports.File({ filename: path.join(runtimeDir, 'rejections.log') })
   ]
 });
 
-export default logger;
+export default logger;

package/src/paths.js

@@ -0,0 +1,22 @@
+import path from "node:path";
+import process from "node:process";
+
+export function getUserHomeDir() {
+  return process.env.USERPROFILE || process.env.HOME || process.cwd();
+}
+
+export function getLorenHome() {
+  return process.env.LOREN_HOME || path.join(getUserHomeDir(), ".lorencode");
+}
+
+export function getEnvFilePath() {
+  return path.join(getLorenHome(), ".env.local");
+}
+
+export function getRuntimeDir() {
+  return path.join(getLorenHome(), "runtime");
+}
+
+export function getLegacyEnvFilePath(projectRoot) {
+  return path.join(projectRoot, ".env.local");
+}

package/src/server.js

@@ -6,6 +6,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { loadConfig } from "./config.js";
 import { ensureEnvLocal, ensureRuntimeDir } from "./bootstrap.js";
+import { getEnvFilePath } from "./paths.js";
 import logger from "./logger.js";
 import { KeyManager } from "./key-manager.js";
 import { validateInput, MessageSchema, CountTokensSchema } from "./schemas.js";
@@ -20,12 +21,12 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const projectRoot = path.resolve(__dirname, "..");
 
-ensureRuntimeDir(projectRoot);
+ensureRuntimeDir();
 ensureEnvLocal(projectRoot, { logger });
 
 let config = loadConfig();
 let keyManager = new KeyManager(config.apiKeys);
-const envFilePath = path.join(projectRoot, ".env.local");
+const envFilePath = getEnvFilePath();
 
 function reloadRuntimeConfig() {
   config = loadConfig();
@@ -57,7 +58,7 @@ process.on('SIGTERM', () => {
 });
 
 if (!config.apiKeys.length) {
-  logger.error('No Ollama API keys found. Set OLLAMA_API_KEYS or OLLAMA_API_KEY in the environment or .env.local.');
+  logger.error(`No Ollama API keys found. Set OLLAMA_API_KEYS or OLLAMA_API_KEY in the environment or ${envFilePath}.`);
   process.exit(1);
 }