@getlore/cli 0.4.0 → 0.5.1

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

@@ -0,0 +1,8 @@
+/**
+ * Ingest Command
+ *
+ * Push content directly into Lore from the CLI.
+ * Accepts inline text, a file path, or piped stdin.
+ */
+import type { Command } from 'commander';
+export declare function registerIngestCommand(program: Command, defaultDataDir: string): void;

package/dist/cli/commands/ingest.js

@@ -0,0 +1,104 @@
+/**
+ * Ingest Command
+ *
+ * Push content directly into Lore from the CLI.
+ * Accepts inline text, a file path, or piped stdin.
+ */
+import { readFileSync, existsSync } from 'fs';
+import path from 'path';
+export function registerIngestCommand(program, defaultDataDir) {
+    program
+        .command('ingest')
+        .description('Ingest content into the knowledge base')
+        .argument('[content]', 'Content to ingest (or use --file / stdin)')
+        .option('-f, --file <path>', 'Read content from a file')
+        .option('-t, --title <title>', 'Document title')
+        .option('-p, --project <project>', 'Project name', 'default')
+        .option('--type <type>', 'Source type (e.g. meeting, notes, article)')
+        .option('--url <url>', 'Source URL for citation linking')
+        .option('--name <name>', 'Human-readable source name')
+        .option('--tags <tags>', 'Comma-separated tags')
+        .option('-d, --data-dir <dir>', 'Data directory', defaultDataDir)
+        .action(async (contentArg, options) => {
+        const { handleIngest } = await import('../../mcp/handlers/ingest.js');
+        const dataDir = options.dataDir;
+        const dbPath = path.join(dataDir, 'lore.lance');
+        // Resolve content from argument, file, or stdin
+        let content;
+        if (options.file) {
+            const filePath = options.file.replace(/^~/, process.env.HOME || '~');
+            if (!existsSync(filePath)) {
+                console.error(`File not found: ${filePath}`);
+                process.exit(1);
+            }
+            content = readFileSync(filePath, 'utf-8');
+        }
+        else if (contentArg) {
+            content = contentArg;
+        }
+        else if (!process.stdin.isTTY) {
+            // Reading from pipe/stdin
+            content = readFileSync(0, 'utf-8');
+        }
+        else {
+            console.error('No content provided. Use one of:');
+            console.error('  lore ingest "Your content here"');
+            console.error('  lore ingest --file ./notes.md');
+            console.error('  echo "content" | lore ingest');
+            process.exit(1);
+        }
+        content = content.trim();
+        if (!content) {
+            console.error('Content is empty.');
+            process.exit(1);
+        }
+        // Derive title from file name or content
+        let title = options.title;
+        if (!title && options.file) {
+            title = path.basename(options.file, path.extname(options.file));
+        }
+        if (!title) {
+            // Use first line or first 60 chars
+            const firstLine = content.split('\n')[0].replace(/^#+\s*/, '');
+            title = firstLine.length > 60 ? firstLine.slice(0, 57) + '...' : firstLine;
+        }
+        const tags = options.tags ? options.tags.split(',').map((t) => t.trim()) : [];
+        console.log(`\nIngesting: ${title}`);
+        console.log(`Project:   ${options.project}`);
+        if (options.type)
+            console.log(`Type:      ${options.type}`);
+        console.log(`Content:   ${content.length} chars`);
+        console.log('');
+        const result = await handleIngest(dbPath, dataDir, {
+            content,
+            title,
+            project: options.project,
+            source_type: options.type,
+            tags,
+            source_url: options.url,
+            source_name: options.name,
+        }, {
+            hookContext: { mode: 'cli' },
+        });
+        if (result.deduplicated) {
+            console.log('Already exists (identical content). Skipped.');
+            return;
+        }
+        if (result.success) {
+            console.log(`Ingested (ID: ${result.id})`);
+            if (result.indexed) {
+                console.log('Indexed and searchable.');
+            }
+            else {
+                console.log('Saved to disk. Run "lore sync" to index.');
+            }
+            if (result.synced) {
+                console.log('Pushed to git.');
+            }
+        }
+        else {
+            console.error('Ingestion failed.');
+            process.exit(1);
+        }
+    });
+}

package/dist/index.js

@@ -30,6 +30,7 @@ import { registerAskCommand } from './cli/commands/ask.js';
 import { registerAuthCommands } from './cli/commands/auth.js';
 import { registerSkillsCommand } from './cli/commands/skills.js';
 import { registerUpdateCommand } from './cli/commands/update.js';
+import { registerIngestCommand } from './cli/commands/ingest.js';
 import { getExtensionRegistry, getLoreVersionString } from './extensions/registry.js';
 import { bridgeConfigToEnv } from './core/config.js';
 import { expandPath } from './sync/config.js';
@@ -78,6 +79,7 @@ registerAskCommand(program, DEFAULT_DATA_DIR);
 registerAuthCommands(program);
 registerSkillsCommand(program);
 registerUpdateCommand(program, DEFAULT_DATA_DIR);
+registerIngestCommand(program, DEFAULT_DATA_DIR);
 // Extension system — hidden from top-level help for now
 const extensionCmd = registerExtensionCommands(program);
 extensionCmd._hidden = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlore/cli",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Research knowledge repository with semantic search, citations, and project lineage tracking",
   "type": "module",
   "main": "dist/index.js",

package/plugins/claude-code/skills/lore/SKILL.md

@@ -8,6 +8,18 @@ user-invocable: false
 
 Lore is a research knowledge repository available via MCP. It stores documents, meeting notes, interviews, and decisions with full citations back to original sources. Use it to ground your work in evidence and preserve important context.
 
+## First-Time Setup
+
+If Lore is not installed yet, you can set it up for the user. The process requires their input at two points.
+
+1. **Install**: `npm install -g @getlore/cli` (requires Node.js 18+)
+2. **Ask the user** for their **email address** and their **OpenAI** and **Anthropic API keys**
+3. **Send OTP**: Run `lore setup --openai-key <key> --anthropic-key <key> --email <email> --data-dir ~/.lore` — this sends a 6-digit code to their email and exits
+4. **Ask the user** for the **6-digit code** from their email
+5. **Complete setup**: Re-run the same command with `--code <code>` appended — this verifies and finishes setup
+
+After setup, Lore works autonomously. No further user input is needed for searching, ingesting, or syncing.
+
 ## MCP Tools
 
 | Tool | Cost | Use For |

package/plugins/codex/SKILL.md

@@ -7,6 +7,18 @@ description: Search and ingest knowledge from Lore — a research repository wit
 
 Lore is a research knowledge repository available via MCP. It stores documents, meeting notes, interviews, and decisions with full citations back to original sources. Use it to ground your work in evidence and preserve important context.
 
+## First-Time Setup
+
+If Lore is not installed yet, you can set it up for the user. The process requires their input at two points.
+
+1. **Install**: `npm install -g @getlore/cli` (requires Node.js 18+)
+2. **Ask the user** for their **email address** and their **OpenAI** and **Anthropic API keys**
+3. **Send OTP**: Run `lore setup --openai-key <key> --anthropic-key <key> --email <email> --data-dir ~/.lore` — this sends a 6-digit code to their email and exits
+4. **Ask the user** for the **6-digit code** from their email
+5. **Complete setup**: Re-run the same command with `--code <code>` appended — this verifies and finishes setup
+
+After setup, Lore works autonomously. No further user input is needed for searching, ingesting, or syncing.
+
 ## MCP Tools
 
 | Tool | Cost | Use For |

package/plugins/gemini/GEMINI.md

@@ -2,6 +2,18 @@
 
 Lore is a research knowledge repository available via MCP. It stores documents, meeting notes, interviews, and decisions with full citations back to original sources. Use it to ground your work in evidence and preserve important context.
 
+## First-Time Setup
+
+If Lore is not installed yet, you can set it up for the user. The process requires their input at two points.
+
+1. **Install**: `npm install -g @getlore/cli` (requires Node.js 18+)
+2. **Ask the user** for their **email address** and their **OpenAI** and **Anthropic API keys**
+3. **Send OTP**: Run `lore setup --openai-key <key> --anthropic-key <key> --email <email> --data-dir ~/.lore` — this sends a 6-digit code to their email and exits
+4. **Ask the user** for the **6-digit code** from their email
+5. **Complete setup**: Re-run the same command with `--code <code>` appended — this verifies and finishes setup
+
+After setup, Lore works autonomously. No further user input is needed for searching, ingesting, or syncing.
+
 ## MCP Tools
 
 | Tool | Cost | Use For |

package/skills/generic-agent.md

@@ -2,6 +2,18 @@
 
 Lore is a research knowledge repository accessible via MCP (Model Context Protocol). It stores documents with full-text search, semantic search, and citation tracking. Content is deduplicated, embedded for retrieval, and organized by project.
 
+## First-Time Setup
+
+If Lore is not installed yet, you can set it up for the user. The process requires their input at two points.
+
+1. **Install**: `npm install -g @getlore/cli` (requires Node.js 18+)
+2. **Ask the user** for their **email address** and their **OpenAI** and **Anthropic API keys**
+3. **Send OTP**: Run `lore setup --openai-key <key> --anthropic-key <key> --email <email> --data-dir ~/.lore` — this sends a 6-digit code to their email and exits
+4. **Ask the user** for the **6-digit code** from their email
+5. **Complete setup**: Re-run the same command with `--code <code>` appended — this verifies and finishes setup
+
+After setup, Lore works autonomously. No further user input is needed for searching, ingesting, or syncing.
+
 ## Core Concepts
 
 - **Sources**: Full documents (meeting notes, interviews, Slack threads, specs, etc.)