sampler-cli 0.2.0

Token-efficient CLI for indexing and searching code symbols (Python-first, designed for minimal LLM/agent context size)

Sampler

CLI indexer para navegar símbolos y relaciones en codebases multiproyecto.

Versión actual: 0.1.2

Requisitos

• Python 3.11+
• uv (recomendado)
• Go (instalado para soporte parser Fase 1)

Instalación de Go (macOS)

brew install go
go version

Instalación

pip install sampler-cli

Para desarrollo (incluye tests, linters):

pip install -e '.[dev]'

Uso rápido

pip install sampler-cli
sampler init
sampler project add myproj /absolute/path --language python
sampler project list
sampler index myproj
sampler search add --project myproj
sampler overview /absolute/path/file.py

Demo / LLM use (token-efficient by design):

• Default outputs are compact single-line (no tables, short paths, no noise).
• Ideal for pasting into agents/LLMs with minimal context size.
• Example: sampler search worker --project myproj → myproj:src/tasks.py:42 function process def process()

Estado actual

Implementado:

• Bootstrap inicial de Fase 0
• Configuración global con archivo ~/.sampler/config.yaml
• CRUD de proyectos en config (add, list, remove)
• Esquema SQLite core + queries de index/search en src/sampler/db.py
• Discovery de archivos por lenguaje con soporte .gitignore
• Parser Python estable basado en AST
• Indexer real (hash incremental + persistencia)
• Query engine real (search, overview)
• CI básico con GitHub Actions (pytest -q)
• Tests: smoke, config, db, cli, discovery, python_parser, index_query

Nota de estabilidad:

• Se desactivó uso runtime de tree-sitter en parser Python por crash nativo (BUS/SEGV) en indexación real.
• Se mantiene estrategia AST para estabilidad en producción local.

Pendiente inmediato:

• Filtros y paginación en búsqueda
• Comandos callers, usages, related
• Parsers Go y TypeScript/JavaScript

Estructura clave

src/sampler/cli/main.py          # comandos CLI
src/sampler/config.py            # config global YAML
src/sampler/db.py                # capa SQLite
src/sampler/indexer/builder.py   # indexación de proyectos
src/sampler/indexer/store.py     # persistencia de símbolos/relaciones
src/sampler/indexer/parsers/python.py # parser python estable
src/sampler/query/engine.py      # search/overview
src/sampler/indexer/discover.py  # discovery y filtros
tests/                           # pruebas base

Ejecutar pruebas

pytest -q