Metadata-Version: 2.4
Name: clewso
Version: 0.1.8
Summary: 🧶👀 Context Engine for AI Agents - Hybrid vector + graph code search
Project-URL: Homepage, https://github.com/clewnet/clewso
Project-URL: Documentation, https://github.com/clewnet/clewso#readme
Project-URL: Repository, https://github.com/clewnet/clewso
Project-URL: Issues, https://github.com/clewnet/clewso/issues
Author-email: Matt Davidson <matt@matchdav.io>
License-Expression: AGPL-3.0-only
License-File: LICENSE
Keywords: agents,ai,code-search,context,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: clewso-ingestion>=0.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: neo4j>=5.14.0
Requires-Dist: real-ladybug>=0.15.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tenacity>=8.2.0
Requires-Dist: typer>=0.9.0
Provides-Extra: all
Requires-Dist: asyncpg>=0.29.0; extra == 'all'
Requires-Dist: fastapi>=0.109.0; extra == 'all'
Requires-Dist: mcp>=1.0.0; extra == 'all'
Requires-Dist: numpy>=2.4.2; extra == 'all'
Requires-Dist: pandas>=3.0.0; extra == 'all'
Requires-Dist: pydantic-settings>=2.1.0; extra == 'all'
Requires-Dist: pydantic>=2.5.0; extra == 'all'
Requires-Dist: sentence-transformers>=2.2.2; extra == 'all'
Requires-Dist: uvicorn[standard]>=0.27.0; extra == 'all'
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == 'mcp'
Requires-Dist: pydantic>=2.5.0; extra == 'mcp'
Provides-Extra: server
Requires-Dist: asyncpg>=0.29.0; extra == 'server'
Requires-Dist: fastapi>=0.109.0; extra == 'server'
Requires-Dist: numpy>=2.4.2; extra == 'server'
Requires-Dist: pandas>=3.0.0; extra == 'server'
Requires-Dist: pydantic-settings>=2.1.0; extra == 'server'
Requires-Dist: pydantic>=2.5.0; extra == 'server'
Requires-Dist: sentence-transformers>=2.2.2; extra == 'server'
Requires-Dist: uvicorn[standard]>=0.27.0; extra == 'server'
Description-Content-Type: text/markdown

<p align="center">
<pre>
    ,;;;,.
   ;;O  O;;
   `;    ;'
    `;;;;'
   ~~/  \~~
  ~/    _ \~
 ~/   (.) \~
~/ ~~~~~~~~\~
</pre>
</p>

<h1 align="center">Clewso 🧶👀</h1>
<h3 align="center">The Open Source Context Server for AI Agents.</h3>

<p align="center">
  <strong>Runs locally. Indexes your repo. 100% Privacy.</strong>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue" alt="License"></a>
  <a href="https://github.com/clewnet/clewso/actions/workflows/publish.yml"><img src="https://github.com/clewnet/clewso/actions/workflows/publish.yml/badge.svg" alt="Publish"></a>
  <a href="https://pypi.org/project/clewso/"><img src="https://img.shields.io/pypi/v/clewso.svg" alt="PyPI"></a>
  <a href="https://clewso.sh"><img src="https://img.shields.io/badge/docs-clewso.sh-blue" alt="Docs"></a>
</p>

---

Clewso indexes your codebase and gives AI agents **structured, navigable context** by combining **vector search** (Qdrant) with **graph traversal** (Neo4j).

## Quick Start

```bash
uv tool install clewso       # or: pip install clewso
clewso init                   # configure stores (local Docker or cloud)
clewso index ./my-repo        # index your codebase
clewso setup-editor           # configure your AI editor
clewso review --staged        # graph-aware code review
```

## Features

- **Hybrid search** — semantic vectors + code graph in one query
- **MCP tools** — drop-in for Claude Code, Cursor, Copilot, Gemini, Windsurf
- **Smart review** — context-aware PR review with impact graph analysis
- **Local-first** — your machine, your data, no cloud dependency

## Packages

| Package | Description |
|---|---|
| [`clewso`](https://pypi.org/project/clewso/) | CLI — index, review, editor setup |
| [`clewso-ingestion`](https://pypi.org/project/clewso-ingestion/) | Repo indexing pipeline |
| [`clewso-core`](https://pypi.org/project/clewso-core/) | Shared types and embedding client |

## Documentation

Full docs at **[clewso.sh](https://clewso.sh)**.

## License

[AGPL-3.0](LICENSE)
