Metadata-Version: 2.4
Name: codecrawler
Version: 0.1.0
Summary: Local-first code search CLI with semantic embeddings. grep + AI for developers.
Author: codecrawler contributors
License: MIT
Project-URL: Homepage, https://github.com/morata43-png/codecrawler
Project-URL: Issues, https://github.com/morata43-png/codecrawler/issues
Keywords: code-search,semantic-search,embeddings,ai,cli,grep,developer-tools,local-first
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Dynamic: license-file

# codesearch-cli

> Local-first code search with semantic embeddings. Search by meaning, not just keywords.

A lightweight CLI tool that searches your codebase. Two modes:
- **Keyword search** (default): Fast regex-based search like `ripgrep`
- **Semantic search** (`--semantic`): Finds conceptually similar code using local embeddings

## Why codesearch-cli?

- ✅ **Local-first**: Runs entirely on your machine, no API calls
- ✅ **No API costs**: No OpenAI/Anthropic dependency
- ✅ **Fast**: Built in Python with smart skipping of irrelevant files
- ✅ **Privacy**: Your code never leaves your machine
- ✅ **Open source**: MIT license, code on GitHub

## Installation

```bash
pipx install codesearch-cli
```

Or with pip:

```bash
pip install --user codesearch-cli
```

## Usage

### Keyword search (default)

```bash
# Find all TODO comments in Python files
codesearch "TODO|FIXME"

# Case-sensitive search
codesearch "MyClass" --case-sensitive

# Search specific file types
codesearch "import requests" --glob "*.py"

# Substring search (no regex)
codesearch "my_function" --type substring
```

### Semantic search (coming soon)

```bash
# Find code that "validates email addresses" (concept, not exact match)
codesearch "function that validates email format" --semantic
```

## What it detects

| Mode | Best for | Speed |
|------|----------|-------|
| **Keyword** | Exact matches, regex patterns, function names | Very fast |
| **Semantic** | Concept-based search ("find me auth code") | Slower (model download) |

## Pricing

| Tier | Price | Features |
|------|-------|----------|
| **Free** | $0/mes | 1 repo, keyword search, basic filters |
| **Pro** | **$5/mes** | Unlimited repos, semantic search, custom rules, multi-repo sync |
| **Team** | $15/mes | Team analytics, shared rules, priority support |

## License

MIT
