Metadata-Version: 2.4
Name: lensdev
Version: 0.1.2
Summary: Local AI research agent that generates structured research workspaces
Author: Sarthak
Project-URL: Homepage, https://pypi.org/project/lensdev/
Project-URL: Repository, https://github.com/developer8sarthak/lens-research
Project-URL: Documentation, https://lensdev.pages.dev/
Project-URL: Issues, https://github.com/developer8sarthak/lens-research/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: rich

# Lens

Lens is a local AI research agent that takes a query, performs structured research, and stores results in a persistent workspace.

## Installation

```bash
pip install lensdev
```

## Usage

Run a research task:

```bash
lens research -q "how do vector databases work"
```

## Workspace System

Every run generates a workspace:

`workspace/<session_id>/`

Example:

`workspace/session_20260604_143210/`

### Structure:

- `report.md`
- `sources.json`
- `meta.json`

## CLI Commands

### Run research:

```bash
lens research -q "query"
```

### List sessions:

```bash
lens list
```

### Resume session:

```bash
lens resume <session_id>
```

## Output Behavior

After completion:

```
Research complete.
Workspace saved at: workspace/<session_id>/
```

## Philosophy

Lens turns research into structured, persistent workspaces instead of temporary terminal output.

---
**GitHub:** [https://github.com/developer8sarthak/lens-research](https://github.com/developer8sarthak/lens-research)  
**PyPI:** [https://pypi.org/project/lensdev/](https://pypi.org/project/lensdev/)  
**Documentation:** [https://lensdev.pages.dev/](https://lensdev.pages.dev/)
