loren-code 0.1.5 → 0.2.1

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.5",
+  "version": "0.2.1",
   "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
@@ -271,10 +285,8 @@ $ps1Content = @"
 Set-Content -LiteralPath $claudePs1Path -Value $ps1Content -Encoding UTF8
 
 Write-Host "Installation completed."
-Write-Host "Claude launcher:" $launcherExePath
-Write-Host "VS Code user settings:" $workspaceSettingsPath
-Write-Host "Claude user settings:" $claudeSettingsPath
-Write-Host "Global Claude command:" $claudeCmdPath
 Write-Host ""
-Write-Host "Restart VS Code. Claude Code will use the bridge in any project."
-Write-Host "The global 'claude' command now routes through Loren."
+Write-Host "Claude Code is now wired to Loren."
+Write-Host "Restart VS Code and open a fresh chat."
+Write-Host "The global 'claude' command now goes through Loren too."
+Write-Host "Tiny goblins have been escorted away from the terminal."

package/scripts/loren.js

@@ -1,33 +1,32 @@
 #!/usr/bin/env node
 import fs from "node:fs";
 import path from "node:path";
+import process from "node:process";
 import { execFileSync, spawn } from "node:child_process";
+import { createInterface } from "node:readline/promises";
 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");
 const userHome = process.env.USERPROFILE || process.env.HOME || projectRoot;
 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 ASCII_LOGO = `
-██╗      ██████╗ ██████╗ ███████╗███╗   ██╗     ██████╗ ██████╗ ██████╗ ███████╗
-██║     ██╔═══██╗██╔══██╗██╔════╝████╗  ██║    ██╔════╝██╔═══██╗██╔══██╗██╔════╝
-██║     ██║   ██║██████╔╝█████╗  ██╔██╗ ██║    ██║     ██║   ██║██║  ██║█████╗
-██║     ██║   ██║██╔══██╗██╔══╝  ██║╚██╗██║    ██║     ██║   ██║██║  ██║██╔══╝
-███████╗╚██████╔╝██║  ██║███████╗██║ ╚████║    ╚██████╗╚██████╔╝██████╔╝███████╗
-╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═══╝     ╚═════╝ ╚═════╝ ╚═════╝ ╚══════
+ensureRuntimeDir();
+const envStatus = ensureEnvLocal(projectRoot, { logger: { warn() {} } });
+
+const BANNER = `
+LOREN CODE
+Smarter bridge, fewer rituals.
 `;
 
 const COMMANDS = {
@@ -45,6 +44,7 @@ const COMMANDS = {
   },
   config: {
     show: showConfig,
+    paths: showPaths,
   },
   server: {
     start: startServer,
@@ -53,16 +53,25 @@ const COMMANDS = {
   },
 };
 
-function main() {
+async function main() {
   const args = process.argv.slice(2);
   const [command] = args;
+  const config = loadConfig();
+
+  if (!command) {
+    await runSetupWizard(config);
+    return;
+  }
 
-  if (!command || command === "help" || command === "--help" || command === "-h") {
+  if (command === "help" || command === "--help" || command === "-h") {
     printHelp();
-    process.exit(0);
+    return;
   }
 
-  const [category, action] = command.split(":");
+  if (command === "setup") {
+    await runSetupWizard(config);
+    return;
+  }
 
   if (command === "start") {
     startServer();
@@ -79,24 +88,24 @@ function main() {
     return;
   }
 
+  const [category, action] = command.split(":");
   if (category && action && COMMANDS[category] && COMMANDS[category][action]) {
-    COMMANDS[category][action](args.slice(1));
+    await COMMANDS[category][action](args.slice(1));
     return;
   }
 
   console.error(`Unknown command: ${command}`);
-  printHelp();
+  console.log("");
+  console.log("Run `loren help` if the command goblin struck again.");
   process.exit(1);
 }
 
-// ============== MODEL COMMANDS ==============
-
 async function listModels() {
   const config = loadConfig();
 
   try {
     const response = await fetch(`${config.upstreamBaseUrl}/api/tags`, {
-      headers: { "accept": "application/json" },
+      headers: { accept: "application/json" },
     });
 
     if (!response.ok) {
@@ -106,7 +115,6 @@ async function listModels() {
     const data = await response.json();
     let models = Array.isArray(data.models) ? data.models : [];
 
-    // Sort by modified date (most recent first)
     models = models.sort((a, b) => {
       const dateA = a.modified_at ? new Date(a.modified_at).getTime() : 0;
       const dateB = b.modified_at ? new Date(b.modified_at).getTime() : 0;
@@ -123,9 +131,7 @@ async function listModels() {
       const size = formatSize(model.size);
       const modified = model.modified_at ? new Date(model.modified_at).toLocaleDateString() : "unknown";
       const marker = modelId === config.defaultModel ? "●" : "○";
-      console.log(
-        `${marker} ${modelId.padEnd(28)}${size.padStart(12)}${modified.padStart(12)}`
-      );
+      console.log(`${marker} ${modelId.padEnd(28)}${size.padStart(12)}${modified.padStart(12)}`);
     }
 
     console.log("");
@@ -139,21 +145,24 @@ async function listModels() {
 }
 
 function formatSize(bytes) {
-  if (!bytes) return "unknown";
+  if (!bytes) {
+    return "unknown";
+  }
+
   const gb = bytes / (1024 ** 3);
   return `${gb.toFixed(1)} GB`;
 }
 
 async function refreshModels() {
   const config = loadConfig();
-  const url = `http://${config.host}:${config.port}/v1/refresh`;
+  const url = `${getBridgeBaseUrl(config)}/v1/refresh`;
 
-  console.log(`Sending refresh request to ${url}...`);
+  console.log("Refreshing the model list...");
 
   try {
     const response = await fetch(url, {
       method: "POST",
-      headers: { "accept": "application/json" },
+      headers: { accept: "application/json" },
     });
 
     if (!response.ok) {
@@ -163,12 +172,11 @@ async function refreshModels() {
     const data = await response.json();
     const models = Array.isArray(data.data) ? data.data : [];
 
-    console.log("\n✓ Models refreshed successfully!");
-    console.log(`  Fetched ${models.length} model(s) from Ollama Cloud.`);
+    console.log(`\nDone. Fetched ${models.length} model(s).`);
     console.log("");
   } catch (error) {
     console.error(`Error refreshing models: ${error.message}`);
-    console.error("Make sure the server is running: loren start");
+    console.error("Tip: start the bridge first with `loren start`.");
     process.exit(1);
   }
 }
@@ -177,31 +185,27 @@ function setModel(args) {
   const requestedModel = args.join(" ").trim();
 
   if (!requestedModel) {
-    console.error("Error: Specify a model name.");
+    console.error("Please specify a model name.");
     console.error("Example: loren model:set qwen3.5:397b");
     process.exit(1);
   }
 
   const config = loadConfig();
-
-  // Check if it's a valid alias or add it as a new direct model
   const isValidAlias = Object.keys(config.aliases).includes(requestedModel);
 
   if (!isValidAlias) {
-    console.warn(`Warning: '${requestedModel}' is not a configured alias.`);
-    console.warn("It will be used as a direct model name.");
+    console.warn(`Using '${requestedModel}' as a direct model name.`);
   }
 
-  // Update .env.local with new DEFAULT_MODEL_ALIAS
   const envVars = loadEnvFile(envFilePath);
   envVars.DEFAULT_MODEL_ALIAS = requestedModel;
   saveEnvFile(envFilePath, envVars);
   syncClaudeSelectedModel(requestedModel);
 
-  console.log(`\n✓ Default model set to: ${requestedModel}`);
-  console.log("  New requests will use this model immediately.");
+  console.log(`\nDefault model set to ${requestedModel}.`);
+  console.log("Fresh requests will use it right away.");
   if (fs.existsSync(claudeSettingsPath)) {
-    console.log("  Claude Code settings were updated as well.");
+    console.log("Claude Code settings were updated too.");
   }
   console.log("");
 }
@@ -212,18 +216,16 @@ function showCurrentModel() {
   console.log("");
 }
 
-// ============== API KEY COMMANDS ==============
-
 function listKeys() {
   const config = loadConfig();
 
-  console.log("\nConfigured API Keys:");
+  console.log("\nConfigured API keys:");
   console.log("─".repeat(40));
 
   if (config.apiKeys.length === 0) {
-    console.log("  (none configured)");
+    console.log("  none yet");
   } else {
-    for (let i = 0; i < config.apiKeys.length; i++) {
+    for (let i = 0; i < config.apiKeys.length; i += 1) {
       const key = config.apiKeys[i];
       const masked = `${key.slice(0, 4)}...${key.slice(-4)}`;
       const marker = i === 0 ? "●" : "○";
@@ -232,27 +234,22 @@ function listKeys() {
   }
 
   console.log("");
-  console.log(`Total: ${config.apiKeys.length} key(s)`);
-  console.log("");
 }
 
 function addKey(args) {
   const newKey = args.join(" ").trim();
 
   if (!newKey) {
-    console.error("Error: Specify an API key.");
+    console.error("Please specify an API key.");
     console.error("Example: loren keys:add sk-your-key-here");
     process.exit(1);
   }
 
   const envVars = loadEnvFile(envFilePath);
-  const existingKeys = (envVars.OLLAMA_API_KEYS || "")
-    .split(/[,\r?\n]+/)
-    .map((k) => k.trim())
-    .filter(Boolean);
+  const existingKeys = splitKeyList(envVars.OLLAMA_API_KEYS);
 
   if (existingKeys.includes(newKey)) {
-    console.log("  Key already exists, skipping.");
+    console.log("That key is already there. Loren noticed before I did.");
     return;
   }
 
@@ -260,9 +257,7 @@ function addKey(args) {
   envVars.OLLAMA_API_KEYS = existingKeys.join(",");
   saveEnvFile(envFilePath, envVars);
 
-  console.log(`\n✓ API key added.`);
-  console.log(`  Total keys: ${existingKeys.length}`);
-  console.log("  New key will be used for subsequent requests.");
+  console.log(`\nKey added. Total keys: ${existingKeys.length}`);
   console.log("");
 }
 
@@ -270,71 +265,64 @@ function removeKey(args) {
   const indexOrKey = args.join(" ").trim();
 
   if (!indexOrKey) {
-    console.error("Error: Specify key index or the key itself.");
+    console.error("Please specify a key index or the full key.");
     console.error("Example: loren keys:remove 0");
-    console.error("         loren keys:remove sk-xxx...");
     process.exit(1);
   }
 
   const envVars = loadEnvFile(envFilePath);
-  let existingKeys = (envVars.OLLAMA_API_KEYS || "")
-    .split(/[,\r?\n]+/)
-    .map((k) => k.trim())
-    .filter(Boolean);
+  let existingKeys = splitKeyList(envVars.OLLAMA_API_KEYS);
 
   let keyToRemove;
-  const index = parseInt(indexOrKey, 10);
-
-  if (!isNaN(index) && index >= 0 && index < existingKeys.length) {
+  const index = Number.parseInt(indexOrKey, 10);
+  if (!Number.isNaN(index) && index >= 0 && index < existingKeys.length) {
     keyToRemove = existingKeys[index];
   } else {
-    keyToRemove = existingKeys.find((k) => k === indexOrKey);
+    keyToRemove = existingKeys.find((key) => key === indexOrKey);
   }
 
   if (!keyToRemove) {
-    console.error("Error: Key not found.");
+    console.error("Key not found.");
     process.exit(1);
   }
 
-  existingKeys = existingKeys.filter((k) => k !== keyToRemove);
+  existingKeys = existingKeys.filter((key) => key !== keyToRemove);
   envVars.OLLAMA_API_KEYS = existingKeys.join(",");
   saveEnvFile(envFilePath, envVars);
 
-  console.log(`\n✓ API key removed.`);
-  console.log(`  Remaining keys: ${existingKeys.length}`);
+  console.log(`\nKey removed. Remaining keys: ${existingKeys.length}`);
   console.log("");
 }
 
-function rotateKeys(args) {
+function rotateKeys() {
   const envVars = loadEnvFile(envFilePath);
-  let existingKeys = (envVars.OLLAMA_API_KEYS || "")
-    .split(/[,\r?\n]+/)
-    .map((k) => k.trim())
-    .filter(Boolean);
+  let existingKeys = splitKeyList(envVars.OLLAMA_API_KEYS);
 
   if (existingKeys.length < 2) {
-    console.log("Need at least 2 keys to rotate.");
+    console.log("You need at least two keys to rotate.");
     return;
   }
 
-  // Move first key to the end
   const [first, ...rest] = existingKeys;
   existingKeys = [...rest, first];
-
   envVars.OLLAMA_API_KEYS = existingKeys.join(",");
   saveEnvFile(envFilePath, envVars);
 
-  console.log("\n✓ API keys rotated.");
-  console.log("  First key moved to end of list.");
+  console.log("\nKeys rotated. The first one took a well-earned break.");
   console.log("");
 }
 
-// ============== CONFIG COMMANDS ==============
+function splitKeyList(raw = "") {
+  return raw
+    .split(/[,\r?\n]+/)
+    .map((entry) => entry.trim())
+    .filter(Boolean);
+}
 
 function showConfig() {
   const config = loadConfig();
 
-  console.log("\nCurrent Configuration:");
+  console.log("\nCurrent configuration:");
   console.log("─".repeat(40));
   console.log(`  Host:        ${config.host}`);
   console.log(`  Port:        ${config.port}`);
@@ -345,73 +333,70 @@ function showConfig() {
   console.log("");
 }
 
-// ============== SERVER COMMANDS ==============
+function showPaths() {
+  console.log("\nLoren paths:");
+  console.log("─".repeat(40));
+  console.log(`  Home:        ${lorenHome}`);
+  console.log(`  Config:      ${envFilePath}`);
+  console.log(`  Runtime:     ${runtimeDir}`);
+  console.log("");
+}
 
 function startServer() {
   const existingPid = readPidFile();
   if (existingPid && isProcessRunning(existingPid)) {
     const config = loadConfig();
-    console.log(`\nLoren server is already running (PID ${existingPid}).`);
-    console.log(`  URL: ${getBridgeBaseUrl(config)}`);
+    console.log("\nLoren is already running.");
+    console.log(`URL: ${getBridgeBaseUrl(config)}`);
     console.log("");
     return;
   }
 
-  if (!fs.existsSync(runtimeDir)) {
-    fs.mkdirSync(runtimeDir, { recursive: true });
-  }
+  fs.mkdirSync(runtimeDir, { recursive: true });
 
   const child = spawn(process.execPath, [path.join(projectRoot, "src", "server.js")], {
     cwd: projectRoot,
     detached: true,
-    stdio: [
-      "ignore",
-      fs.openSync(logFilePath, "a"),
-      fs.openSync(errorLogFilePath, "a"),
-    ],
+    stdio: ["ignore", fs.openSync(logFilePath, "a"), fs.openSync(errorLogFilePath, "a")],
     windowsHide: true,
   });
 
   child.unref();
-  const pid = child.pid;
-
-  fs.writeFileSync(pidFilePath, `${pid}\n`, "utf8");
+  fs.writeFileSync(pidFilePath, `${child.pid}\n`, "utf8");
 
   const config = loadConfig();
-  console.log(`\n✓ Loren server started (PID ${pid}).`);
-  console.log(`  URL: ${getBridgeBaseUrl(config)}`);
+  console.log("\nLoren is up and listening.");
+  console.log(`URL: ${getBridgeBaseUrl(config)}`);
   console.log("");
 }
 
 function stopServer() {
   const pid = readPidFile();
   if (!pid) {
-    console.log("\nLoren server is not running.");
+    console.log("\nLoren is not running.");
     console.log("");
     return;
   }
 
   if (!isProcessRunning(pid)) {
     safeUnlink(pidFilePath);
-    console.log(`\nRemoved stale PID file for process ${pid}.`);
+    console.log("\nCleaned up a stale PID file.");
     console.log("");
     return;
   }
 
   try {
     if (process.platform === "win32") {
-      execFileSync("taskkill.exe", ["/PID", `${pid}`, "/T", "/F"], {
-        stdio: "ignore",
-      });
+      execFileSync("taskkill.exe", ["/PID", `${pid}`, "/T", "/F"], { stdio: "ignore" });
     } else {
       process.kill(pid, "SIGINT");
     }
 
     safeUnlink(pidFilePath);
-    console.log(`\n✓ Loren server stopped (PID ${pid}).`);
+    console.log("\nLoren stopped cleanly.");
     console.log("");
   } catch (error) {
-    console.error(`Error stopping server: ${error.message}`);
+    console.error(`Error stopping Loren: ${error.message}`);
     process.exit(1);
   }
 }
@@ -421,15 +406,12 @@ function showServerStatus() {
   const pid = readPidFile();
   const running = pid ? isProcessRunning(pid) : false;
 
-  console.log("\nServer Status:");
+  console.log("\nServer status:");
   console.log("─".repeat(40));
   console.log(`  Running:     ${running ? "yes" : "no"}`);
   console.log(`  Host:        ${config.host}`);
   console.log(`  Port:        ${config.port}`);
   console.log(`  URL:         ${getBridgeBaseUrl(config)}`);
-  if (pid) {
-    console.log(`  PID:         ${pid}${running ? "" : " (stale)"}`);
-  }
   console.log("");
 }
 
@@ -446,15 +428,11 @@ function readPidFile() {
 function isProcessRunning(pid) {
   if (process.platform === "win32") {
     try {
-      const output = execFileSync("powershell.exe", [
-        "-NoProfile",
-        "-Command",
-        `Get-Process -Id ${pid} -ErrorAction Stop | Select-Object -ExpandProperty Id`,
-      ], {
-        encoding: "utf8",
-        stdio: ["ignore", "pipe", "ignore"],
-      }).trim();
-
+      const output = execFileSync(
+        "powershell.exe",
+        ["-NoProfile", "-Command", `Get-Process -Id ${pid} -ErrorAction Stop | Select-Object -ExpandProperty Id`],
+        { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] },
+      ).trim();
       return output === `${pid}`;
     } catch {
       return false;
@@ -497,47 +475,134 @@ function syncClaudeSelectedModel(model) {
   fs.writeFileSync(claudeSettingsPath, `${JSON.stringify(settings, null, 2)}\n`, "utf8");
 }
 
-// ============== HELP ==============
+async function runSetupWizard(config) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    printHelp();
+    printQuickSetup(config);
+    return;
+  }
+
+  if (config.apiKeys.length > 0) {
+    printWelcomeBack(config);
+    return;
+  }
+
+  printWizardIntro();
+
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    const rawKeys = (await rl.question("Paste your Ollama API key(s), separated by commas: ")).trim();
+
+    if (rawKeys) {
+      const keys = splitKeyList(rawKeys);
+      const envVars = loadEnvFile(envFilePath);
+      envVars.OLLAMA_API_KEYS = keys.join(",");
+      saveEnvFile(envFilePath, envVars);
+      console.log(`\nNice. Loren is holding ${keys.length} key(s) and feeling organized.`);
+    } else {
+      console.log("\nNo keys yet. Loren will wait here and act casual about it.");
+    }
+
+    const startNow = (await rl.question("Start the bridge now? [Y/n] ")).trim().toLowerCase();
+    if (startNow === "" || startNow === "y" || startNow === "yes") {
+      startServer();
+    }
+
+    if (process.platform === "win32") {
+      const installClaude = (await rl.question("Install Claude Code integration too? [y/N] ")).trim().toLowerCase();
+      if (installClaude === "y" || installClaude === "yes") {
+        installClaudeIntegration();
+      } else {
+        console.log("\nNo problem. You can wire Claude in later.");
+      }
+    }
+
+    console.log("Setup complete. Fewer steps, fewer goblins.");
+    console.log("");
+  } finally {
+    rl.close();
+  }
+}
+
+function printWizardIntro() {
+  console.log(BANNER);
+  if (envStatus.migrated) {
+    console.log("Your previous settings were imported automatically.");
+  } else if (envStatus.created) {
+    console.log("A fresh config is ready.");
+  }
+  console.log("Let's get Loren ready in one quick pass.");
+  console.log("");
+}
+
+function printWelcomeBack(config) {
+  console.log(BANNER);
+  console.log(`Welcome back. ${config.apiKeys.length} key(s) loaded.`);
+  console.log(`Current default model: ${config.defaultModel}`);
+  console.log("");
+  console.log("Useful commands:");
+  console.log("  loren start");
+  console.log("  loren model:list");
+  console.log("  loren config:show");
+  console.log("");
+}
+
+function printQuickSetup(config) {
+  if (config.apiKeys.length > 0) {
+    console.log("Run `loren start` to launch the bridge.");
+    console.log("");
+    return;
+  }
+
+  console.log("Quick start:");
+  console.log("  1. Run `loren` in an interactive terminal");
+  console.log("  2. Add your Ollama API key(s)");
+  console.log("  3. Start the bridge");
+  console.log("");
+}
+
+function installClaudeIntegration() {
+  const scriptPath = path.join(projectRoot, "scripts", "install-claude-ollama.ps1");
+
+  try {
+    execFileSync("powershell.exe", ["-ExecutionPolicy", "Bypass", "-File", scriptPath], {
+      stdio: "inherit",
+    });
+  } catch (error) {
+    console.error(`Couldn't install Claude integration automatically: ${error.message}`);
+  }
+}
 
 function printHelp() {
-  console.log(ASCII_LOGO);
-  console.log(`
-LOREN CODE - Ollama Cloud Model Manager
-────────────────────────────────────────────────────
-
-MODEL COMMANDS:
-  loren model:list              Fetch & list models from Ollama Cloud
-  loren model:set <name>        Set default model (immediate effect)
-  loren model:current           Show current default model
-  loren model:refresh           Force refresh models cache
-
-KEY COMMANDS:
-  loren keys:list               List configured API keys
-  loren keys:add <key>          Add a new API key
-  loren keys:remove <idx|key>   Remove a key by index or value
-  loren keys:rotate             Rotate keys (move first to end)
-
-CONFIG COMMANDS:
-  loren config:show             Show current configuration
-
-SERVER COMMANDS:
-  loren start                   Start bridge server (port 8788)
-  loren stop                    Stop bridge server
-  loren status                  Show bridge server status
-
-EXAMPLES:
-  loren model:list
-  loren model:set gpt-oss:20b
-  loren model:refresh
-  loren keys:add sk-ollama-abc123...
-  loren keys:remove 0
-  loren config:show
-
-TIPS:
-  - Model changes take effect immediately for new requests
-  - Use model:refresh after changing model to update Claude Code's list
-  - Models are sorted by modification date (most recent first)
-`);
+  console.log(BANNER);
+  console.log("Commands:");
+  console.log("  loren setup                 Run the setup wizard");
+  console.log("  loren start                 Start the bridge");
+  console.log("  loren stop                  Stop the bridge");
+  console.log("  loren status                Show bridge status");
+  console.log("  loren model:list            List models");
+  console.log("  loren model:set <name>      Set the default model");
+  console.log("  loren model:current         Show the current model");
+  console.log("  loren model:refresh         Refresh cached models");
+  console.log("  loren keys:list             List API keys");
+  console.log("  loren keys:add <key>        Add an API key");
+  console.log("  loren keys:remove <value>   Remove an API key");
+  console.log("  loren keys:rotate           Rotate configured keys");
+  console.log("  loren config:show           Show current config");
+  console.log("  loren config:paths          Show Loren paths");
+  console.log("");
+  console.log("Examples:");
+  console.log("  loren");
+  console.log("  loren start");
+  console.log("  loren model:set gpt-oss:20b");
+  console.log("");
 }
 
-main();
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});

package/scripts/postinstall.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+console.log("");
+console.log("Loren Code is installed.");
+console.log("Run `loren` to begin setup.");
+console.log("No treasure map required.");
+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,27 +1,38 @@
 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?.("Existing Loren settings were migrated automatically.");
+    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.`);
+    logger.warn?.("A fresh Loren config was created. Add your Ollama API key(s) before starting the bridge.");
     return { created: true, path: envLocalPath };
   }
 
   fs.copyFileSync(envExamplePath, envLocalPath);
-  logger.warn?.(`Created ${envLocalPath} from .env.example. Add your real Ollama API key(s) before starting the bridge.`);
+  logger.warn?.("A fresh Loren config was created from the template. Add your real Ollama API key(s) before starting the bridge.");
   return { created: true, path: envLocalPath };
 }
 

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);
 }