Metadata-Version: 2.4
Name: docketeer-search
Version: 0.0.17
Summary: Semantic workspace search plugin for Docketeer
Project-URL: Homepage, https://github.com/chrisguidry/docketeer
Project-URL: Repository, https://github.com/chrisguidry/docketeer
Project-URL: Issues, https://github.com/chrisguidry/docketeer/issues
Author-email: Chris Guidry <guid@omg.lol>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Text Processing :: Indexing
Requires-Python: >=3.12
Requires-Dist: docketeer
Requires-Dist: fastembed
Description-Content-Type: text/markdown

# docketeer-search

Semantic search plugin for [Docketeer](https://github.com/chrisguidry/docketeer).

Uses [fastembed](https://github.com/qdrant/fastembed) (ONNX-based, CPU-only) for
text embeddings and [sqlite-vec](https://github.com/asg017/sqlite-vec) for vector
storage and retrieval.

## What it provides

- **`docketeer.search` entry point** — a `SearchCatalog` implementation that
  manages named search indices (e.g. `workspace` for files, `mcp-tools` for
  MCP tool discovery)
- **`docketeer.tasks` entry point** — background tasks for async indexing
  via Docket
- **`docketeer-search reindex` CLI** — full workspace reindex for initial setup
  or recovery

The core `search_files` tool automatically uses semantic search when this
plugin is installed, falling back to keyword grep without it.

## Usage

Install alongside docketeer:

```sh
uv add docketeer-search
```

Build the initial index:

```sh
docketeer-search reindex
```

The agent will keep the index current as it writes and deletes files.
