@ridit/lens 0.2.2 → 0.2.4

package/LENS.md

@@ -1,25 +1,68 @@
-# Lens Analysis
-> Generated: 2026-03-11T17:49:46.564Z
+# Lens - Codebase Intelligence Tool
 
-## Overview
-This project is a CLI tool called 'lens' that analyzes a repository and provides insights. It uses React, Ink, and various other libraries to create a text-based interface. The tool has several commands, including 'repo' for analyzing a remote repository, 'init' for initializing the tool, and 'review' for reviewing a local codebase. The project is designed for developers who want to quickly understand a repository's structure and content.
+Lens is a CLI tool that helps developers understand, navigate, and interact with codebases using AI-powered analysis.
 
-## Important Folders
-- src/components: contains various components, including FileReviewer, FileViewer, and ProviderPicker. Each component is used to display specific information about the repository.
-- src/commands: contains the implementation of the 'repo', 'init', and 'review' commands. Each command has its own file and exports a function that handles the command's logic.
-- src/utils: contains utility functions for tasks such as cloning a repository, reading files, and analyzing code. These functions are used throughout the project to perform specific tasks.
+## Core Features
 
-## Missing Configs
-- None detected
+- **Repository Analysis**: Analyze both local and remote repositories
+- **AI-Powered Insights**: Uses LLMs to understand code structure and content
+- **Interactive Chat**: Converse with your codebase using natural language
+- **Code Review**: Automated code reviews with specific suggestions
+- **Timeline Exploration**: Explore commit history and code evolution
+- **Task Automation**: Apply natural language changes to codebases
 
-## Security Issues
-- None detected
+## Supported AI Providers
 
-## Suggestions
-- In src/components/FileReviewer.tsx, consider adding a check to ensure that the 'files' prop is not empty before rendering the file list.
-- In src/commands/repo.tsx, consider adding error handling for cases where the repository URL is invalid or the repository cannot be cloned.
-- In src/utils/llm.ts, consider adding a timeout to the 'runPrompt' function to prevent it from running indefinitely if the model takes too long to respond.
+- Anthropic
+- Gemini (Google AI)
+- OpenAI
+- Ollama (local models)
+- Custom endpoints
 
-<!--lens-json
-{"overview":"This project is a CLI tool called 'lens' that analyzes a repository and provides insights. It uses React, Ink, and various other libraries to create a text-based interface. The tool has several commands, including 'repo' for analyzing a remote repository, 'init' for initializing the tool, and 'review' for reviewing a local codebase. The project is designed for developers who want to quickly understand a repository's structure and content.","importantFolders":["src/components: contains various components, including FileReviewer, FileViewer, and ProviderPicker. Each component is used to display specific information about the repository.","src/commands: contains the implementation of the 'repo', 'init', and 'review' commands. Each command has its own file and exports a function that handles the command's logic.","src/utils: contains utility functions for tasks such as cloning a repository, reading files, and analyzing code. These functions are used throughout the project to perform specific tasks."],"missingConfigs":[],"securityIssues":[],"suggestions":["In src/components/FileReviewer.tsx, consider adding a check to ensure that the 'files' prop is not empty before rendering the file list.","In src/commands/repo.tsx, consider adding error handling for cases where the repository URL is invalid or the repository cannot be cloned.","In src/utils/llm.ts, consider adding a timeout to the 'runPrompt' function to prevent it from running indefinitely if the model takes too long to respond."],"generatedAt":"2026-03-11T17:49:46.564Z"}
-lens-json-->
+## Technical Architecture
+
+- Built with React components rendered in terminal via Ink
+- TypeScript throughout for type safety
+- Bun as build tool and runtime
+- Commander.js for CLI structure
+- Modular command system with separate handlers
+
+## Commands
+
+- `lens repo <url>` - Analyze a remote repository
+- `lens review [path]` - Review a local codebase
+- `lens task <text>` - Apply natural language changes
+- `lens chat` - Interactive chat with codebase
+- `lens timeline` - Explore commit history
+- `lens provider` - Configure AI providers
+
+## Key Components
+
+- **Smart File Selection**: AI determines which files are most important
+- **Structured Analysis**: Provides overviews, folder insights, and suggestions
+- **Security Scanning**: Identifies potential security issues
+- **Multi-Model Support**: Flexible AI backend configuration
+
+## Installation
+
+```bash
+npm install -g @ridit/lens
+```
+
+## Usage
+
+```bash
+# Analyze a GitHub repository
+lens repo https://github.com/user/repo
+
+# Review local codebase
+lens review .
+
+# Chat with your code
+lens chat --path .
+
+# Make changes with natural language
+lens task "Add TypeScript types to this component" --path .
+```
+
+Lens helps developers quickly understand complex codebases through AI-assisted analysis and natural language interaction.

package/dist/index.mjs

@@ -35841,6 +35841,43 @@ var require_jsx_dev_runtime = __commonJS((exports, module) => {
   }
 });
 
+// src/utils/tools/registry.ts
+class ToolRegistry {
+  tools = new Map;
+  register(tool) {
+    if (this.tools.has(tool.name)) {
+      console.warn(`[ToolRegistry] Overwriting existing tool: "${tool.name}"`);
+    }
+    this.tools.set(tool.name, tool);
+  }
+  unregister(name) {
+    this.tools.delete(name);
+  }
+  get(name) {
+    return this.tools.get(name);
+  }
+  all() {
+    return Array.from(this.tools.values());
+  }
+  names() {
+    return Array.from(this.tools.keys());
+  }
+  buildSystemPromptSection() {
+    const lines = [`## TOOLS
+`];
+    lines.push("You have exactly " + this.tools.size + ` tools. To use a tool you MUST wrap it in the exact XML tags shown below — no other format will work.
+`);
+    let i = 1;
+    for (const tool of this.tools.values()) {
+      lines.push(tool.systemPromptEntry(i++));
+    }
+    return lines.join(`
+`);
+  }
+}
+var registry = new ToolRegistry;
+globalThis.__lens_registry = registry;
+
 // node_modules/ink/build/render.js
 import { Stream } from "node:stream";
 import process13 from "node:process";
@@ -49805,42 +49842,6 @@ Got it — I'll always use bun for this project.`
 Done — removed that memory.`
   }
 ];
-// src/utils/tools/registry.ts
-class ToolRegistry {
-  tools = new Map;
-  register(tool) {
-    if (this.tools.has(tool.name)) {
-      console.warn(`[ToolRegistry] Overwriting existing tool: "${tool.name}"`);
-    }
-    this.tools.set(tool.name, tool);
-  }
-  unregister(name) {
-    this.tools.delete(name);
-  }
-  get(name) {
-    return this.tools.get(name);
-  }
-  all() {
-    return Array.from(this.tools.values());
-  }
-  names() {
-    return Array.from(this.tools.keys());
-  }
-  buildSystemPromptSection() {
-    const lines = [`## TOOLS
-`];
-    lines.push("You have exactly " + this.tools.size + ` tools. To use a tool you MUST wrap it in the exact XML tags shown below — no other format will work.
-`);
-    let i = 1;
-    for (const tool of this.tools.values()) {
-      lines.push(tool.systemPromptEntry(i++));
-    }
-    return lines.join(`
-`);
-  }
-}
-var registry = new ToolRegistry;
-
 // src/utils/chat.ts
 function parseResponse(text) {
   const scanText = text.replace(/```[\s\S]*?```/g, (m) => " ".repeat(m.length));
@@ -52368,8 +52369,8 @@ function appendMemory(entry) {
 }
 function buildMemorySummary(repoPath) {
   const m = loadMemoryFile();
-  const relevant = m.entries.filter((e) => e.repoPath === repoPath).slice(-50);
-  const memories = m.memories.filter((mem) => mem.repoPath === repoPath);
+  const relevant = m.entries.slice(-50);
+  const memories = m.memories;
   const parts = [];
   if (memories.length > 0) {
     parts.push(`## MEMORIES ABOUT THIS REPO
@@ -52395,8 +52396,8 @@ ${lines.join(`
 }
 function clearRepoMemory(repoPath) {
   const m = loadMemoryFile();
-  m.entries = m.entries.filter((e) => e.repoPath !== repoPath);
-  m.memories = m.memories.filter((mem) => mem.repoPath !== repoPath);
+  m.entries = m.entries = [];
+  m.memories = m.memories = [];
   saveMemoryFile(m);
 }
 function generateId() {
@@ -52407,8 +52408,7 @@ function addMemory(content, repoPath) {
   const memory = {
     id: generateId(),
     content,
-    timestamp: new Date().toISOString(),
-    repoPath
+    timestamp: new Date().toISOString()
   };
   m.memories.push(memory);
   saveMemoryFile(m);
@@ -52417,14 +52417,14 @@ function addMemory(content, repoPath) {
 function deleteMemory(id, repoPath) {
   const m = loadMemoryFile();
   const before2 = m.memories.length;
-  m.memories = m.memories.filter((mem) => !(mem.id === id && mem.repoPath === repoPath));
+  m.memories = m.memories.filter((mem) => !(mem.id === id));
   if (m.memories.length === before2)
     return false;
   saveMemoryFile(m);
   return true;
 }
 function listMemories(repoPath) {
-  return loadMemoryFile().memories.filter((mem) => mem.repoPath === repoPath);
+  return loadMemoryFile().memories;
 }
 
 // src/components/chat/ChatRunner.tsx
@@ -53678,9 +53678,32 @@ function registerBuiltins() {
   registry.register(changesTool);
 }
 
+// src/utils/addons/loadAddons.ts
+import path21 from "path";
+import os10 from "os";
+import { existsSync as existsSync16, readdirSync as readdirSync5 } from "fs";
+var ADDONS_DIR = path21.join(os10.homedir(), ".lens", "addons");
+async function loadAddons() {
+  if (!existsSync16(ADDONS_DIR)) {
+    return;
+  }
+  const files = readdirSync5(ADDONS_DIR).filter((f) => f.endsWith(".js") && !f.startsWith("_"));
+  for (const file of files) {
+    const fullPath = path21.join(ADDONS_DIR, file);
+    try {
+      await import(fullPath);
+      console.log(`[addons] loaded: ${file}
+`);
+    } catch (err) {
+      console.error(`[addons] failed to load ${file}:`, err instanceof Error ? err.message : String(err));
+    }
+  }
+}
+
 // src/index.tsx
 var jsx_dev_runtime25 = __toESM(require_jsx_dev_runtime(), 1);
 registerBuiltins();
+await loadAddons();
 var program2 = new Command;
 program2.command("repo <url>").description("Analyze a remote repository").action((url) => {
   render_default(/* @__PURE__ */ jsx_dev_runtime25.jsxDEV(RepoCommand, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ridit/lens",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Know Your Codebase.",
   "author": "Ridit Jangra <riditjangra09@gmail.com> (https://ridit.space)",
   "license": "MIT",
@@ -18,6 +18,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@ridit/lens-sdk": "0.1.4",
     "commander": "^14.0.3",
     "figures": "^6.1.0",
     "ink": "^6.8.0",

package/src/index.tsx

@@ -1,4 +1,5 @@
 import React from "react";
+import "./utils/tools/registry";
 import { render } from "ink";
 import { Command } from "commander";
 import { RepoCommand } from "./commands/repo";
@@ -8,8 +9,10 @@ import { TaskCommand } from "./commands/task";
 import { ChatCommand } from "./commands/chat";
 import { TimelineCommand } from "./commands/timeline";
 import { registerBuiltins } from "./utils/tools/builtins";
+import { loadAddons } from "./utils/addons/loadAddons";
 
 registerBuiltins();
+await loadAddons();
 
 const program = new Command();
 

package/src/utils/addons/loadAddons.ts

@@ -0,0 +1,29 @@
+import path from "path";
+import os from "os";
+import { existsSync, readdirSync } from "fs";
+
+const ADDONS_DIR = path.join(os.homedir(), ".lens", "addons");
+
+export async function loadAddons(): Promise<void> {
+  if (!existsSync(ADDONS_DIR)) {
+    // Silently skip — no addons directory yet
+    return;
+  }
+
+  const files = readdirSync(ADDONS_DIR).filter(
+    (f) => f.endsWith(".js") && !f.startsWith("_"),
+  );
+
+  for (const file of files) {
+    const fullPath = path.join(ADDONS_DIR, file);
+    try {
+      await import(fullPath);
+      console.log(`[addons] loaded: ${file}\n`);
+    } catch (err) {
+      console.error(
+        `[addons] failed to load ${file}:`,
+        err instanceof Error ? err.message : String(err),
+      );
+    }
+  }
+}

package/src/utils/chat.ts

@@ -22,7 +22,7 @@ export { buildSystemPrompt, FEW_SHOT_MESSAGES } from "../prompts";
 import type { Message } from "../types/chat";
 import type { Provider } from "../types/config";
 import { FEW_SHOT_MESSAGES } from "../prompts";
-import { registry } from "./tools/registry";
+import { registry } from "../utils/tools/registry";
 import type { FilePatch } from "../components/repo/DiffViewer";
 
 export type ParsedResponse =

package/src/utils/memory.ts

@@ -15,14 +15,12 @@ export type MemoryEntry = {
   detail: string;
   summary: string;
   timestamp: string;
-  repoPath: string;
 };
 
 export type Memory = {
   id: string;
   content: string;
   timestamp: string;
-  repoPath: string;
 };
 
 export type MemoryFile = {
@@ -64,9 +62,9 @@ export function appendMemory(entry: Omit<MemoryEntry, "timestamp">): void {
 
 export function buildMemorySummary(repoPath: string): string {
   const m = loadMemoryFile();
-  const relevant = m.entries.filter((e) => e.repoPath === repoPath).slice(-50);
+  const relevant = m.entries.slice(-50);
 
-  const memories = m.memories.filter((mem) => mem.repoPath === repoPath);
+  const memories = m.memories;
 
   const parts: string[] = [];
 
@@ -92,13 +90,13 @@ export function buildMemorySummary(repoPath: string): string {
 }
 
 export function getRepoMemory(repoPath: string): MemoryEntry[] {
-  return loadMemoryFile().entries.filter((e) => e.repoPath === repoPath);
+  return loadMemoryFile().entries;
 }
 
 export function clearRepoMemory(repoPath: string): void {
   const m = loadMemoryFile();
-  m.entries = m.entries.filter((e) => e.repoPath !== repoPath);
-  m.memories = m.memories.filter((mem) => mem.repoPath !== repoPath);
+  m.entries = m.entries = [];
+  m.memories = m.memories = [];
   saveMemoryFile(m);
 }
 
@@ -114,7 +112,6 @@ export function addMemory(content: string, repoPath: string): Memory {
     id: generateId(),
     content,
     timestamp: new Date().toISOString(),
-    repoPath,
   };
   m.memories.push(memory);
   saveMemoryFile(m);
@@ -124,14 +121,12 @@ export function addMemory(content: string, repoPath: string): Memory {
 export function deleteMemory(id: string, repoPath: string): boolean {
   const m = loadMemoryFile();
   const before = m.memories.length;
-  m.memories = m.memories.filter(
-    (mem) => !(mem.id === id && mem.repoPath === repoPath),
-  );
+  m.memories = m.memories.filter((mem) => !(mem.id === id));
   if (m.memories.length === before) return false;
   saveMemoryFile(m);
   return true;
 }
 
 export function listMemories(repoPath: string): Memory[] {
-  return loadMemoryFile().memories.filter((mem) => mem.repoPath === repoPath);
+  return loadMemoryFile().memories;
 }

package/src/utils/tools/builtins.ts

@@ -1,4 +1,4 @@
-import type { Tool, ToolContext, ToolResult } from "./registry";
+import type { Tool, ToolContext } from "@ridit/lens-sdk";
 import {
   fetchUrl,
   searchWeb,

package/src/utils/tools/registry.ts

@@ -10,65 +10,7 @@
 //   import { registry } from "lens/tools/registry";
 //   registry.register({ name: "my-tool", ... });
 
-export interface ToolContext {
-  repoPath: string;
-  /** All messages in the current conversation so far */
-  messages: unknown[];
-}
-
-export type ToolResult =
-  | { kind: "text"; value: string }
-  | { kind: "error"; value: string };
-
-export interface Tool<TInput = string> {
-  /**
-   * Tag name used in XML: <name>...</name>
-   * Must be lowercase, hyphens allowed. Must be unique.
-   */
-  name: string;
-
-  /**
-   * Short description shown in system prompt and /help.
-   */
-  description: string;
-
-  /**
-   * System prompt snippet explaining how to invoke this tool.
-   * Return the full ### N. name — description block.
-   */
-  systemPromptEntry(index: number): string;
-
-  /**
-   * Parse the raw inner text of the XML tag into a typed input.
-   * Throw or return null to signal a parse failure (tool will be skipped).
-   */
-  parseInput(body: string): TInput | null;
-
-  /**
-   * Execute the tool. May be async.
-   * Return a ToolResult — the value is fed back to the model as the tool result.
-   */
-  execute(input: TInput, ctx: ToolContext): Promise<ToolResult> | ToolResult;
-
-  /**
-   * Whether this tool is safe to auto-approve (read-only, no side effects).
-   * Defaults to false.
-   */
-  safe?: boolean;
-
-  /**
-   * Optional: permission prompt label shown to the user before execution.
-   * e.g. "run", "read", "write", "delete"
-   * Defaults to the tool name.
-   */
-  permissionLabel?: string;
-
-  /**
-   * Optional: summarise the input for display in the chat history.
-   * Defaults to showing the raw input string.
-   */
-  summariseInput?(input: TInput): string;
-}
+import type { Tool } from "@ridit/lens-sdk";
 
 // ── Registry ──────────────────────────────────────────────────────────────────
 
@@ -117,3 +59,5 @@ class ToolRegistry {
 }
 
 export const registry = new ToolRegistry();
+
+(globalThis as any).__lens_registry = registry;

package/hello.py

@@ -1,51 +0,0 @@
-# hello.py
-# A simple script that reads a text file, makes an HTTP request,
-# and prints the result in a friendly way.
-
-import json
-import pathlib
-import sys
-from urllib.request import urlopen
-
-def read_local_file(path: str) -> str:
-    """Read the contents of a file and return it as a string."""
-    file_path = pathlib.Path(path)
-    if not file_path.is_file():
-        raise FileNotFoundError(f"❌ File not found: {path}")
-    return file_path.read_text(encoding="utf-8")
-
-def fetch_json(url: str) -> dict:
-    """Fetch JSON from a URL and decode it into a Python dict."""
-    with urlopen(url) as response:
-        if response.status != 200:
-            raise RuntimeError(f"❌ HTTP {response.status} from {url}")
-        data = response.read()
-        return json.loads(data)
-
-def main():
-    # 1️⃣ Read a local file (optional – you can comment this out)
-    try:
-        local_content = read_local_file("example.txt")
-        print("📄 Contents of example.txt:")
-        print(local_content)
-    except FileNotFoundError:
-        print("⚠️ example.txt not found – skipping that step.")
-
-    # 2️⃣ Fetch some JSON data from a public API
-    url = "https://api.github.com/repos/python/cpython"
-    print(f"\n🌐 Fetching data from {url} …")
-    repo_info = fetch_json(url)
-
-    # 3️⃣ Extract a couple of useful fields and display them
-    name = repo_info.get("name")
-    stars = repo_info.get("stargazers_count")
-    description = repo_info.get("description")
-    print("\n🔎 Repository info:")
-    print(f"• Name: {name}")
-    print(f"• Stars: {stars:,}")          # adds commas for readability
-    print(f"• Description: {description}")
-
-    return 0
-
-if __name__ == "__main__":
-    sys.exit(main())