Metadata-Version: 2.4
Name: vectorless-code
Version: 0.1.1
Summary: Code search and navigation engine powered by vectorless, without vector database.
Project-URL: Homepage, https://vectorless.dev/
Project-URL: Repository, https://github.com/vectorlessflow/vectorless-code
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ast,code-search,tree-sitter,vectorless
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: pathspec>=0.12.1
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich
Requires-Dist: tree-sitter-c>=0.21
Requires-Dist: tree-sitter-cpp>=0.21
Requires-Dist: tree-sitter-go>=0.21
Requires-Dist: tree-sitter-java>=0.21
Requires-Dist: tree-sitter-javascript>=0.21
Requires-Dist: tree-sitter-kotlin>=0.21
Requires-Dist: tree-sitter-python>=0.21
Requires-Dist: tree-sitter-ruby>=0.21
Requires-Dist: tree-sitter-rust>=0.21
Requires-Dist: tree-sitter-scala>=0.21
Requires-Dist: tree-sitter-swift>=0.21
Requires-Dist: tree-sitter-typescript>=0.21
Requires-Dist: tree-sitter>=0.22
Requires-Dist: typer>=0.9.0
Requires-Dist: vectorless>=0.1.13
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# vectorless-code

[![PyPI](https://img.shields.io/pypi/v/vectorless-code.svg)](https://pypi.org/project/vectorless-code/)
[![PyPI Downloads](https://static.pepy.tech/badge/vectorless-code/month)](https://pepy.tech/projects/vectorless-code)

Code-aware search and navigation engine, powered by [`vectorless`](https://github.com/vectorlessflow/vectorless).

## Install

```bash
pip install vectorless-code
```

## Quick start

```bash
# Initialize in your project
vcc init

# Compile the codebase
vcc compile

# Search
vcc ask "where is the authentication logic"
```

## Commands

| Command | Description |
|---------|-------------|
| `vcc init` | Initialize project (creates `.vectorless_code/settings.yml`) |
| `vcc compile` | Compile codebase into searchable index |
| `vcc ask <question>` | Ask a question about the codebase |
| `vcc status` | Show compilation status and index statistics |

`vcc` is the short name. `vectorless-code` also works.

## Development

### Requirements

- Python 3.11+
- [uv](https://docs.astral.sh/uv/) (recommended) or pip

### Setup

```bash
# Clone
git clone https://github.com/vectorlessflow/vectorless-code.git
cd vectorless-code

# Install with dev dependencies (editable mode)
pip install -e ".[dev]"
```

### Run tests

```bash
# Run all tests
python -m pytest tests/ -v

# Run a specific test
python -m pytest tests/test_compile.py::TestDetectLanguage -v
```

### Lint and format

```bash
ruff check src/ tests/ --fix
ruff format src/ tests/
```

### Type check

```bash
mypy src/
```

## License

Apache-2.0
