@getlore/cli 0.2.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2026 Mishkin Faustini. All rights reserved.
+
+This software is proprietary and confidential. No part of this software
+may be reproduced, distributed, or transmitted in any form or by any means
+without the prior written permission of the copyright holder.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# Lore
+
+> The lore behind your projects.
+
+A research knowledge repository with **semantic search** and **citations**. Unlike memory systems that store processed facts, Lore preserves your original sources and lets you cite exactly what was said, by whom, and when.
+
+## Quick Start
+
+```bash
+npm install -g @getlore/cli
+
+# Setup (API keys + login)
+lore setup
+
+# Add a source directory (interactive prompts)
+lore sync add
+
+# Sync and search
+lore sync
+lore search "user pain points"
+```
+
+## What It Does
+
+- **Hybrid Search** — Semantic + keyword search with Reciprocal Rank Fusion
+- **Citations** — Every insight links back to the original source with context
+- **MCP Integration** — 9 tools for Claude Desktop and Claude Code
+- **Agentic Research** — Claude iteratively explores your knowledge, synthesizes findings with citations
+- **Multi-Machine Sync** — Content hash deduplication across machines
+- **Universal Formats** — Markdown, JSONL, JSON, PDF, images, CSV, HTML, and more
+
+## MCP Configuration
+
+Add to your Claude Code or Claude Desktop MCP config:
+
+```json
+{
+  "mcpServers": {
+    "lore": {
+      "command": "lore",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+If the MCP host doesn't inherit your shell environment (e.g. Claude Desktop), add your API keys to the `env` block.
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `lore setup` | Guided configuration wizard |
+| `lore login` | Sign in with email OTP |
+| `lore sync` | Sync all configured sources |
+| `lore sync add` | Add a source directory |
+| `lore search <query>` | Hybrid search |
+| `lore research <query>` | AI-powered deep research |
+| `lore browse` | Interactive TUI browser |
+| `lore docs list` | List documents |
+| `lore projects` | List projects |
+| `lore mcp` | Start MCP server |
+
+## Requirements
+
+- **Node.js** 18+
+- **OpenAI API key** (embeddings)
+- **Anthropic API key** (metadata extraction & research)
+- **Lore account** (free — sign up via `lore login`)
+
+## How Sync Works
+
+1. **Discovery** (free) — Finds files, computes SHA256 hashes, checks for duplicates
+2. **Processing** (new files only) — Claude extracts metadata, OpenAI generates embeddings, stores in Supabase
+
+Same content on different machines produces the same hash — no duplicate processing.
+
+## License
+
+Proprietary. All rights reserved.

package/dist/cli/colors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ANSI color utilities for CLI output
+ */
+export declare const colors: {
+    reset: string;
+    bold: string;
+    dim: string;
+    italic: string;
+    underline: string;
+    inverse: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    red: string;
+    bgGreen: string;
+    bgYellow: string;
+    bgBlue: string;
+    bgRed: string;
+    bgCyan: string;
+    bgMagenta: string;
+};
+/**
+ * Semantic color helpers
+ */
+export declare const c: {
+    title: (s: string) => string;
+    success: (s: string) => string;
+    warning: (s: string) => string;
+    error: (s: string) => string;
+    info: (s: string) => string;
+    dim: (s: string) => string;
+    file: (s: string) => string;
+    path: (s: string) => string;
+    time: (s: string) => string;
+    badge: (s: string, bg: string) => string;
+    bold: (s: string) => string;
+    italic: (s: string) => string;
+    underline: (s: string) => string;
+    code: (s: string) => string;
+    header: (s: string) => string;
+    quote: (s: string) => string;
+    link: (s: string) => string;
+    list: (s: string) => string;
+};

package/dist/cli/colors.js

@@ -0,0 +1,48 @@
+/**
+ * ANSI color utilities for CLI output
+ */
+export const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    italic: '\x1b[3m',
+    underline: '\x1b[4m',
+    inverse: '\x1b[7m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    gray: '\x1b[90m',
+    red: '\x1b[31m',
+    bgGreen: '\x1b[42m',
+    bgYellow: '\x1b[43m',
+    bgBlue: '\x1b[44m',
+    bgRed: '\x1b[41m',
+    bgCyan: '\x1b[46m',
+    bgMagenta: '\x1b[45m',
+};
+/**
+ * Semantic color helpers
+ */
+export const c = {
+    title: (s) => `${colors.bold}${colors.cyan}${s}${colors.reset}`,
+    success: (s) => `${colors.green}${s}${colors.reset}`,
+    warning: (s) => `${colors.yellow}${s}${colors.reset}`,
+    error: (s) => `${colors.bgRed}${colors.white} ${s} ${colors.reset}`,
+    info: (s) => `${colors.blue}${s}${colors.reset}`,
+    dim: (s) => `${colors.dim}${s}${colors.reset}`,
+    file: (s) => `${colors.magenta}${s}${colors.reset}`,
+    path: (s) => `${colors.gray}${s}${colors.reset}`,
+    time: (s) => `${colors.dim}${s}${colors.reset}`,
+    badge: (s, bg) => `${bg}${colors.white}${colors.bold} ${s} ${colors.reset}`,
+    bold: (s) => `${colors.bold}${s}${colors.reset}`,
+    italic: (s) => `${colors.italic}${s}${colors.reset}`,
+    underline: (s) => `${colors.underline}${s}${colors.reset}`,
+    code: (s) => `${colors.bgMagenta}${colors.white}${s}${colors.reset}`,
+    header: (s) => `${colors.bold}${colors.cyan}${s}${colors.reset}`,
+    quote: (s) => `${colors.dim}${colors.italic}${s}${colors.reset}`,
+    link: (s) => `${colors.underline}${colors.blue}${s}${colors.reset}`,
+    list: (s) => `${colors.yellow}•${colors.reset} ${s}`,
+};

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

@@ -0,0 +1,7 @@
+/**
+ * lore ask - AI-powered query of the knowledge base
+ *
+ * Searches relevant sources and uses AI to synthesize an answer.
+ */
+import { Command } from 'commander';
+export declare function registerAskCommand(program: Command, dataDir: string): void;

package/dist/cli/commands/ask.js

@@ -0,0 +1,97 @@
+/**
+ * lore ask - AI-powered query of the knowledge base
+ *
+ * Searches relevant sources and uses AI to synthesize an answer.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { searchSources } from '../../core/vector-store.js';
+import { generateEmbedding } from '../../core/embedder.js';
+const SYSTEM_PROMPT = `You are a research assistant with access to a knowledge base. 
+Your job is to answer questions based on the provided sources.
+
+When answering:
+- Cite specific sources when making claims
+- Be concise but thorough
+- If the sources don't contain enough information, say so
+
+Source format: Each source has an ID, title, and content summary.`;
+export function registerAskCommand(program, dataDir) {
+    const dbPath = `${dataDir}/lore.lance`;
+    program
+        .command('ask <question...>')
+        .description('Ask questions about your knowledge base')
+        .option('-p, --project <name>', 'Filter sources by project')
+        .option('-n, --max-sources <n>', 'Maximum sources to include', '10')
+        .option('-m, --model <model>', 'AI model to use', 'claude-sonnet-4-20250514')
+        .option('-v, --verbose', 'Show source details')
+        .action(async (questionParts, options) => {
+        const question = questionParts.join(' ');
+        if (!process.env.ANTHROPIC_API_KEY) {
+            console.error('Error: ANTHROPIC_API_KEY environment variable required');
+            process.exit(1);
+        }
+        const maxSources = parseInt(options.maxSources || '10', 10);
+        try {
+            // Search for relevant sources
+            console.error('Searching knowledge base...');
+            const embedding = await generateEmbedding(question);
+            const sources = await searchSources(dbPath, embedding, {
+                limit: maxSources,
+                project: options.project,
+                queryText: question,
+                mode: 'hybrid',
+            });
+            if (sources.length === 0) {
+                console.error('No relevant sources found.');
+                if (options.project) {
+                    console.error(`(Filtered by project: ${options.project})`);
+                }
+                process.exit(1);
+            }
+            console.error(`Found ${sources.length} relevant sources`);
+            if (options.verbose) {
+                console.error('\nSources:');
+                for (const source of sources) {
+                    console.error(`  - ${source.title} (${source.id})`);
+                }
+                console.error('');
+            }
+            // Build context from sources
+            const sourceContext = sources.map((s, i) => {
+                const parts = [`[Source ${i + 1}: ${s.title}]`, `ID: ${s.id}`];
+                if (s.summary)
+                    parts.push(`Summary: ${s.summary}`);
+                if (s.themes?.length)
+                    parts.push(`Themes: ${s.themes.map(t => t.name).join(', ')}`);
+                if (s.quotes?.length) {
+                    parts.push('Key quotes:');
+                    for (const q of s.quotes.slice(0, 3)) {
+                        parts.push(`  "${q.text}"`);
+                    }
+                }
+                return parts.join('\n');
+            }).join('\n\n---\n\n');
+            // Stream response
+            console.error('Thinking...\n');
+            const anthropic = new Anthropic();
+            const stream = anthropic.messages.stream({
+                model: options.model || 'claude-sonnet-4-20250514',
+                max_tokens: 4096,
+                system: SYSTEM_PROMPT,
+                messages: [{
+                        role: 'user',
+                        content: `Question: ${question}\n\n---\nSources:\n${sourceContext}`
+                    }],
+            });
+            stream.on('text', (text) => {
+                process.stdout.write(text);
+            });
+            await stream.finalMessage();
+            console.log('');
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Auth Commands
+ *
+ * lore auth login  — interactive OTP flow
+ * lore auth logout — clear session
+ * lore auth whoami — show current user/status
+ * lore setup       — guided wizard (config + login + init + first sync source)
+ */
+import type { Command } from 'commander';
+export declare function registerAuthCommands(program: Command): void;