beoasaver-boop

Port RAG Potty — AI skill for Claude Code

AI community

Sirve a tus agentes de IA (opencode, Claude, Cursor, Cline…) contexto curado de cualquier proyecto: reduce de al rededor de 80-150k tokens de lectura de archivos a 3-5k de respuestas HTTP precisas.

How to install Port RAG Potty

This entry records only its repository, not the path inside it, so there is no exact command to give. Open beoasaver-boop/port-rag-potty and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Port RAG Potty does

Sirve a tus agentes de IA (opencode, Claude, Cursor, Cline…) contexto curado de cualquier proyecto: reduce de al rededor de 80-150k tokens de lectura de archivos a 3-5k de respuestas HTTP precisas. Todo usando modelos locales de embedding como motor de RAG

Alternatives in AI

Graymatter — 30 sec to give your AI agents persistent memory 460 ★
AI Toolkit — Professional-grade AI coding toolkit: 94 skills, 44 agents, multi-platform (Claude, Cursor, Windsurf, Copilot 167 ★
Ag Local Bridge — Local OpenAI, Anthropic & Gemini API bridge for Antigravity — use Claude Sonnet/Opus 4.6, Gemini 3.7/3.6/3.5 49 ★

README

port-rag-potty

RAG portable

**RAG con ChromaDB + Ollama, «cópialo y funciona».** Sirve a tus agentes de IA (opencode, Claude, Cursor, Cline…) contexto curado de cualquier proyecto: reduce de ~80-150k tokens de lectura de archivos a ~3-5k de respuestas HTTP precisas.

Un directorio `rag/` + una plantilla `AGENTS.md` que se copian dentro de **cualquier** proyecto. No está atado a ningún tipo de código (frontend, Python, docs…) — la configuración por proyecto vive en un único `rag.config.json` auto-generado.

Qué resuelve

Un agente nuevo que entra a un repo desconocido hoy se lee README + archivos al completo (80-150k tokens). Con el RAG hace 4-5 llamadas HTTP (~3-5k tokens) y tiene:

/methodology — el «alma» del proyecto: propósito, arquitectura, convenciones (chunks de README/AGENTS marcados como methodology).
/query — búsqueda semántica sobre todo el código (embeddings bge-m3).
/categories — grupos (temas CSS, módulos…) y sus tokens/archivos (opcional).

Requisitos

Docker (para la instalación automatizada) o Python 3.10+ (instalación manual)
Ollama con el modelo de embeddings, por ejemplo bge-m3:
```
ollama pull bge-m3
```
La instalación automatizada usa un contenedor ollama/ollama y pullea el modelo por ti.

Instalación

El repo trae scripts de automatización equivalente en **bash** (`setup.sh`) y **PowerShell** (`setup.ps1`): clonan/buscan el repositorio del RAG, lo copian al proyecto destino, montan los contenedores (Ollama + RAG), pullean el modelo, crean la base Chroma e indexan — todo hasta que `/stats` da `drift = 0`.

Opción A — Automatizada (recomendada, Docker)

# 1) Clona el repositorio del RAG (solo la primera vez)
git clone  rag-portable
cd rag-portable

# 2) Instala el RAG en tu proyecto y déjalo indexado
./setup.sh /ruta/al/proyecto        # bash (Linux/macOS/WSL)
# o en Windows PowerShell:
.\setup.ps1 C:\ruta\al\proyecto