feat: LLM setup UI, AutoLog rename, onboarding wizard, and bug fixes

- Add LLM provider picker to Settings (proxy vs OpenRouter) with
  connection test and explicit apply buttons
- Rename all UI-facing strings from ContextD to AutoLog (windows,
  API docs, onboarding)
- Fix activity_sessions composite PK insert failures with onConflict
  ignore semantics
- Add 2-step onboarding wizard: permissions then LLM provider setup
  with error surfacing for keychain failures
- Fix isUsingProxy false positive when endpoint URL is empty string

Author: AmitSubhash

ContextD/App/AppDelegate.swift

@@ -44,12 +44,12 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
         )
 
         let window = NSWindow(
-            contentRect: NSRect(x: 0, y: 0, width: 520, height: 420),
+            contentRect: NSRect(x: 0, y: 0, width: 520, height: 500),
             styleMask: [.titled, .closable],
             backing: .buffered,
             defer: false
         )
-        window.title = "Welcome to ContextD"
+        window.title = "Welcome to AutoLog"
         window.contentView = NSHostingView(rootView: onboardingView)
         window.center()
         window.isReleasedWhenClosed = false
@@ -106,7 +106,7 @@ final class DebugWindowController {
             defer: false
         )
 
-        window.title = "ContextD - Database Debug"
+        window.title = "AutoLog - Database Debug"
         window.contentView = NSHostingView(rootView: contentView)
         window.center()
         window.isReleasedWhenClosed = false
@@ -160,7 +160,7 @@ final class EnrichmentPanelController {
             defer: false
         )
 
-        panel.title = "ContextD - Enrich Prompt"
+        panel.title = "AutoLog - Enrich Prompt"
         panel.level = .floating
         panel.isFloatingPanel = true
         panel.hidesOnDeactivate = false

ContextD/LLMClient/OpenRouterClient.swift

@@ -15,7 +15,10 @@ final class OpenRouterClient: LLMClient, Sendable {
 
     /// True when using a local proxy (no API key needed).
     static var isUsingProxy: Bool {
-        UserDefaults.standard.string(forKey: "llmEndpointURL") != nil
+        if let custom = UserDefaults.standard.string(forKey: "llmEndpointURL"), !custom.isEmpty {
+            return true
+        }
+        return false
     }
 
     private let logger = DualLogger(category: "OpenRouterClient")

ContextD/Permissions/OnboardingView.swift

@@ -1,23 +1,42 @@
 import SwiftUI
 
 /// First-run onboarding view that guides users through granting
-/// Screen Recording and Accessibility permissions.
+/// permissions and configuring their LLM provider.
 struct OnboardingView: View {
     @ObservedObject var permissionManager: PermissionManager
     var onComplete: () -> Void
 
+    enum Step { case permissions, llmSetup }
+
+    @State private var step: Step = .permissions
+
     var body: some View {
         VStack(spacing: 24) {
-            // Header
+            switch step {
+            case .permissions:
+                permissionsStep
+            case .llmSetup:
+                llmSetupStep
+            }
+        }
+        .padding(32)
+        .frame(width: 520)
+        .animation(.easeInOut(duration: 0.2), value: step)
+    }
+
+    // MARK: - Step 1: Permissions
+
+    private var permissionsStep: some View {
+        VStack(spacing: 24) {
             VStack(spacing: 8) {
                 Image(systemName: "eye.circle.fill")
                     .font(.system(size: 48))
                     .foregroundStyle(.blue)
 
-                Text("Welcome to ContextD")
+                Text("Welcome to AutoLog")
                     .font(.title.bold())
 
-                Text("ContextD needs a few permissions to capture your screen activity and enrich your AI prompts with context.")
+                Text("AutoLog needs a few permissions to capture your screen activity and enrich your AI prompts with context.")
                     .font(.body)
                     .foregroundStyle(.secondary)
                     .multilineTextAlignment(.center)
@@ -26,7 +45,6 @@ struct OnboardingView: View {
 
             Divider()
 
-            // Permissions
             VStack(spacing: 16) {
                 PermissionRow(
                     icon: "rectangle.dashed.badge.record",
@@ -49,15 +67,14 @@ struct OnboardingView: View {
 
             Divider()
 
-            // Actions
             HStack(spacing: 12) {
                 Button("Refresh Status") {
                     permissionManager.refreshStatus()
                 }
                 .buttonStyle(.bordered)
 
-                Button("Continue") {
-                    onComplete()
+                Button("Next") {
+                    step = .llmSetup
                 }
                 .buttonStyle(.borderedProminent)
                 .disabled(!permissionManager.allPermissionsGranted)
@@ -70,8 +87,197 @@ struct OnboardingView: View {
                     .multilineTextAlignment(.center)
             }
         }
-        .padding(32)
-        .frame(width: 520)
+    }
+
+    // MARK: - Step 2: LLM Setup
+
+    @State private var selectedProvider: SettingsView.LLMProvider = .proxy
+    @AppStorage("llmEndpointURL") private var customEndpointURL: String = ""
+    @State private var proxyURL: String = "http://127.0.0.1:11434/v1/chat/completions"
+    @State private var apiKey: String = ""
+    @State private var proxyTestResult: String?
+    @State private var proxyTesting: Bool = false
+    @State private var showApiKeySaved: Bool = false
+    @State private var hasApiKey: Bool = false
+    @State private var saveError: String?
+
+    private var llmConfigured: Bool {
+        switch selectedProvider {
+        case .proxy:
+            return !proxyURL.isEmpty
+        case .openrouter:
+            return hasApiKey
+        }
+    }
+
+    private var llmSetupStep: some View {
+        VStack(spacing: 24) {
+            VStack(spacing: 8) {
+                Image(systemName: "brain.head.profile")
+                    .font(.system(size: 48))
+                    .foregroundStyle(.purple)
+
+                Text("LLM Provider")
+                    .font(.title.bold())
+
+                Text("AutoLog uses an LLM to summarize your screen activity. Choose how to connect.")
+                    .font(.body)
+                    .foregroundStyle(.secondary)
+                    .multilineTextAlignment(.center)
+                    .frame(maxWidth: 400)
+            }
+
+            Divider()
+
+            Picker("Provider:", selection: $selectedProvider) {
+                ForEach(SettingsView.LLMProvider.allCases) { provider in
+                    Text(provider.rawValue).tag(provider)
+                }
+            }
+            .pickerStyle(.segmented)
+
+            if selectedProvider == .proxy {
+                VStack(alignment: .leading, spacing: 8) {
+                    HStack {
+                        TextField("Proxy URL", text: $proxyURL)
+                            .textFieldStyle(.roundedBorder)
+
+                        Button(proxyTesting ? "Testing..." : "Test") {
+                            testProxy()
+                        }
+                        .disabled(proxyURL.isEmpty || proxyTesting)
+                    }
+
+                    Text("Run `claude -p` in a terminal to start the proxy.")
+                        .font(.caption)
+                        .foregroundStyle(.secondary)
+
+                    if let result = proxyTestResult {
+                        HStack {
+                            Image(systemName: result.starts(with: "OK") ? "checkmark.circle.fill" : "xmark.circle.fill")
+                                .foregroundStyle(result.starts(with: "OK") ? .green : .red)
+                            Text(result)
+                                .font(.caption)
+                                .foregroundStyle(result.starts(with: "OK") ? .green : .red)
+                        }
+                    }
+                }
+            } else {
+                VStack(alignment: .leading, spacing: 8) {
+                    HStack {
+                        SecureField("OpenRouter API Key", text: $apiKey)
+                            .textFieldStyle(.roundedBorder)
+
+                        Button(showApiKeySaved ? "Saved!" : "Save") {
+                            saveKey()
+                        }
+                        .disabled(apiKey.isEmpty)
+                    }
+
+                    if let error = saveError {
+                        HStack {
+                            Image(systemName: "exclamationmark.triangle.fill")
+                                .foregroundStyle(.red)
+                            Text(error)
+                                .font(.caption)
+                                .foregroundStyle(.red)
+                        }
+                    }
+
+                    if hasApiKey {
+                        HStack {
+                            Image(systemName: "checkmark.circle.fill")
+                                .foregroundStyle(.green)
+                            Text("API key is configured")
+                                .font(.caption)
+                                .foregroundStyle(.secondary)
+                        }
+                    }
+                }
+            }
+
+            Divider()
+
+            HStack(spacing: 12) {
+                Button("Back") {
+                    step = .permissions
+                }
+                .buttonStyle(.bordered)
+
+                Button("Finish Setup") {
+                    applyProvider()
+                    onComplete()
+                }
+                .buttonStyle(.borderedProminent)
+                .disabled(!llmConfigured)
+            }
+
+            Text("You can change this later in Settings.")
+                .font(.caption)
+                .foregroundStyle(.secondary)
+        }
+        .onAppear {
+            hasApiKey = OpenRouterClient.hasAPIKey()
+        }
+    }
+
+    private func applyProvider() {
+        switch selectedProvider {
+        case .proxy:
+            customEndpointURL = proxyURL
+        case .openrouter:
+            customEndpointURL = ""
+        }
+    }
+
+    private func testProxy() {
+        guard let url = URL(string: proxyURL) else {
+            proxyTestResult = "Invalid URL"
+            return
+        }
+        proxyTesting = true
+        proxyTestResult = nil
+
+        Task {
+            var request = URLRequest(url: url)
+            request.httpMethod = "POST"
+            request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+            request.timeoutInterval = 5
+            let body: [String: Any] = [
+                "model": "anthropic/claude-haiku-4-5",
+                "max_tokens": 1,
+                "messages": [["role": "user", "content": "ping"]],
+            ]
+            request.httpBody = try? JSONSerialization.data(withJSONObject: body)
+
+            do {
+                let (_, response) = try await URLSession.shared.data(for: request)
+                if let http = response as? HTTPURLResponse, (200...499).contains(http.statusCode) {
+                    proxyTestResult = "OK - proxy is reachable (HTTP \(http.statusCode))"
+                } else {
+                    proxyTestResult = "Unexpected response"
+                }
+            } catch {
+                proxyTestResult = "Connection failed: \(error.localizedDescription)"
+            }
+            proxyTesting = false
+        }
+    }
+
+    private func saveKey() {
+        do {
+            try OpenRouterClient.saveAPIKey(apiKey)
+            hasApiKey = true
+            showApiKeySaved = true
+            saveError = nil
+            apiKey = ""
+            Task {
+                try? await Task.sleep(for: .seconds(2))
+                showApiKeySaved = false
+            }
+        } catch {
+            saveError = "Failed to save API key: \(error.localizedDescription)"
+        }
     }
 }
 

ContextD/Server/OpenAPISpec.swift

@@ -7,11 +7,11 @@ enum OpenAPISpec {
     {
       "openapi": "3.1.0",
       "info": {
-        "title": "ContextD API",
-        "description": "Search and browse your recent screen activity. ContextD continuously captures and summarizes what you see on screen, and this API lets you search summaries, list activity, and retrieve structured data from your captures.",
+        "title": "AutoLog API",
+        "description": "Search and browse your recent screen activity. AutoLog continuously captures and summarizes what you see on screen, and this API lets you search summaries, list activity, and retrieve structured data from your captures.",
         "version": "0.1.0",
         "contact": {
-          "name": "ContextD"
+          "name": "AutoLog"
         },
         "license": {
           "name": "MIT"
@@ -20,7 +20,7 @@ enum OpenAPISpec {
       "servers": [
         {
           "url": "http://127.0.0.1:21890",
-          "description": "Local ContextD instance"
+          "description": "Local AutoLog instance"
         }
       ],
       "paths": {
@@ -300,7 +300,7 @@ enum OpenAPISpec {
           "get": {
             "operationId": "healthCheck",
             "summary": "Health check",
-            "description": "Returns the current status of the ContextD API server and basic database statistics.",
+            "description": "Returns the current status of the AutoLog API server and basic database statistics.",
             "responses": {
               "200": {
                 "description": "Server is healthy",

ContextD/Server/ScalarDocsPage.swift

@@ -8,7 +8,7 @@ enum ScalarDocsPage {
         <!DOCTYPE html>
         <html>
         <head>
-            <title>ContextD API Docs</title>
+            <title>AutoLog API Docs</title>
             <meta charset="utf-8" />
             <meta name="viewport" content="width=device-width, initial-scale=1" />
             <style>

ContextD/Storage/StorageManager+Activities.swift

@@ -21,11 +21,11 @@ extension StorageManager {
         return record
     }
 
-    /// Insert an activity-session join record.
+    /// Insert an activity-session join record, ignoring duplicates.
     func insertActivitySession(_ record: ActivitySessionRecord) throws {
         var rec = record
         try database.dbPool.write { db in
-            try rec.insert(db)
+            try rec.insert(db, onConflict: .ignore)
         }
     }