¿Qué hace Búsqueda de Sesiones de Agentes de Codificación (cass)?
Búsqueda de Sesiones de Agentes de Codificación - CLI/TUI unificada para indexar y buscar el historial local de agentes de codificación como Claude Code, Codex, Gemini, Cursor, Aider, ChatGPT, Pi-Agent, Factory y más. Diseñado específicamente para el consumo por agentes de IA con modo robot.
Características
- Indexación Unificada: Indexa sesiones de múltiples agentes de codificación en un solo lugar.
- Búsqueda Potente: Búsqueda rápida y eficiente sobre el historial indexado.
- Modo Robot: Salida optimizada para ser consumida por otros agentes de IA.
- Soporte Multiplataforma: Funciona con Claude Code, Codex, Gemini, Cursor, Aider, ChatGPT, Pi-Agent, Factory, y más.
- Interfaz Dual: CLI para scripts y automatización, TUI para exploración interactiva.
Instalación
git clone https://github.com/Dicklesworthstone/cass.git
cd cass
pip install -r requirements.txt
Uso
Indexar sesiones
python -m cass index --agent claude-code --path ~/.claude/sessions
python -m cass index --agent codex --path ~/.codex/logs
python -m cass index --all
Buscar en el historial
python -m cass search "implementar autenticación OAuth"
python -m cass search "error de compilación en Windows" --limit 10
Modo robot (para agentes de IA)
python -m cass search "configuración de Docker" --robot
Agentes Soportados
| Agente | Ruta por Defecto | Estado |
|---|---|---|
| Claude Code | ~/.claude/sessions | ✅ |
| Codex | ~/.codex/logs | ✅ |
| Gemini | ~/.gemini/sessions | ✅ |
| Cursor | ~/.cursor/sessions | ✅ |
| Aider | ~/.aider/sessions | ✅ |
| ChatGPT | ~/.chatgpt/sessions | ✅ |
| Pi-Agent | ~/.pi-agent/logs | ✅ |
| Factory | ~/.factory/sessions | ✅ |
Configuración
Puedes configurar cass mediante variables de entorno:
CASS_INDEX_DIR: Directorio donde se almacena el índice (por defecto:~/.cass/index)CASS_ROBOT_MODE: Forzar modo robot (true/false)CASS_LOG_LEVEL: Nivel de logging (DEBUG,INFO,WARNING,ERROR)
Ejemplos
Encontrar una sesión de depuración
cass search "fix memory leak" --agent aider --last-week
Listar todas las sesiones indexadas
cass list --all
Obtener resumen de una sesión específica
cass show <session-id> --summary
Integración con Agentes de IA
Para usar cass desde otro agente de IA (por ejemplo, en un prompt de Claude Code):
Ejecuta
python -m cass search "problema con la API de pagos" --roboty usa los resultados para entender el contexto previo.
Licencia
MIT