Sincroniza tu carpeta con ChatGPT: la historia detrás de `openai-folder-sync`

created: viernes, ago 29, 2025

Hace un tiempo seguía encontrándome con el mismo problema: tenía un montón de notas, especificaciones y documentos markdown en mi portátil, pero cuando abría ChatGPT y le hacía preguntas sobre ellos, el modelo obviamente no sabía que existían. Copiar y pegar archivos era tedioso; subirlos manualmente uno por uno no era mucho mejor. Así que construí un pequeño CLI que se encarga de la parte aburrida por mí: openai-folder-sync, una herramienta de línea de comandos que sincroniza un directorio local con un OpenAI Vector Store, para que esos archivos se conviertan en contexto buscable para ChatGPT.

Why a vector store?

La búsqueda de archivos de OpenAI está construida sobre un vector store. Añades archivos a un store, se procesan en embeddings, y los asistentes (o ChatGPT a través de herramientas conectadas) pueden recuperar y fundamentar respuestas usando esos archivos. Es un modelo limpio, pero asume que recordarás subir y mantener tu conjunto de archivos. Un paso de sincronización—que espejea una carpeta que ya te importa—está más cerca de cómo trabajamos día a día.

What the tool does

openai-folder-sync escanea un directorio en tu máquina, filtra archivos por extensión y los sube a un vector store existente. Puedes ejecutarlo una vez para poblar un store, o añadirlo a tu rutina (por ejemplo, un job de cron) para mantener tu base de conocimiento actualizada. También hay una opción para incrustar metadatos de git (branch y commit) en el contenido subido, así que cuando ChatGPT cite algo, sabrás exactamente de qué versión provino.

Espejea una carpeta local en un Vector Store
Soporta filtrado por extensiones (p. ej., md,txt,pdf)
Procedencia git opcional (--git-info)
Puede usarse en scripts o ejecutarse ad-hoc

Repo: https://github.com/JensWalter/openai-folder-sync

Installation

Está escrito en Rust y se instala vía Cargo:

cargo install --git https://github.com/JensWalter/openai-folder-sync.git

Cargo compilará y colocará el binario openai-folder-sync en tu PATH.

Usage

Necesitarás una clave de la API de OpenAI y un ID de vector store existente (se parece a vs_…). Luego apunta el CLI a tu carpeta:

openai-folder-sync \
  --vector-store 'vs_ABCDEFGHIJK' \
  --local-dir '/Users/jens/tmp/wiki/content' \
  --extensions md

¿Prefieres ejecutarlo a través de Cargo durante el desarrollo?

cargo run -- \
  --vector-store 'vs_ABCDEFGHIJK' \
  --local-dir '/Users/jens/tmp/wiki/content' \
  --extensions md

La mayoría de las opciones también pueden establecerse mediante variables de entorno:

export OPENAI_API_KEY=sk-...
export VECTOR_STORE=vs_ABCDEFGHIJK
export LOCAL_DIR=/Users/jens/tmp/wiki/content
export EXTENSIONS=md,txt,pdf
export GIT_INFO=true

openai-folder-sync

Common flags
  --vector-store / VECTOR_STORE – target store ID
  --local-dir / LOCAL_DIR – folder to sync
  --extensions / EXTENSIONS – comma-separated list
  --git-info / GIT_INFO – include git metadata (true|false)
  --help – show all options

How this fits with ChatGPT

Una vez que los archivos estén en un vector store, ChatGPT (o tus apps con la API de Assistants) puede recuperar fragmentos relevantes de esos archivos mientras responde a tus preguntas. Eso significa que puedes preguntar cosas como “¿Qué decía la propuesta sobre el cronograma de migración?” y el modelo extraerá el contexto relevante de tus documentos sincronizados—sin necesidad de copiar y pegar. Tu carpeta se convierte efectivamente en una base de conocimiento viva.

Tips & gotchas

Elige las extensiones con intención. Empieza con los formatos que realmente usas—md, txt, quizá pdf. Esto mantiene el procesamiento rápido y la recuperación focalizada.
Crea el vector store primero. La herramienta espera un ID de store; crea uno vía la API o el panel y luego pásale ese ID al CLI.
Usa la información de git para la procedencia. Si sincronizas desde un repositorio, habilitar –git-info etiqueta el texto subido con metadatos de commit, lo que hace que las respuestas sean más fáciles de confiar y rastrear.
Excluye ruido. Considera mantener artefactos de compilación, node_modules o archivos temporales fuera de tu carpeta de sincronización, o añádelos a .gitignore si dependes de la metadata de git.

Example workflow

Crea un vector store por dominio de conocimiento (p. ej., “Company Wiki”, “Research Notes”).
Apunta openai-folder-sync a la carpeta local correspondiente.
Ejecuta la herramienta como parte de tu rutina de escritura (en mi caso: después de hacer push a main).
Pregunta a ChatGPT y deja que la recuperación haga el trabajo pesado.

Roadmap

Actualmente no tengo más planes para esta herramienta. Si crees que falta algo, abre un issue o un PR.

⸻

Si quieres probarla, el repositorio incluye detalles de instalación y uso además de la ayuda. La construí para simplificar mi propio flujo de trabajo; si te ahorra unas cuantas sesiones de copiar y pegar y ayuda a que ChatGPT responda a partir de tus documentos reales, eso ya es una victoria. ¡Feliz sincronización!