Sync Your Folder to ChatGPT: the story behind `openai-folder-sync`

created: viernes, ago. 29, 2025

Hace un tiempo me encontraba con el mismo problema constantemente: tenía un montón de notas, especificaciones y documentos markdown en mi portátil, pero cuando abría ChatGPT y hacía preguntas sobre ellos, el modelo obviamente no sabía que existían. Copiar y pegar archivos era tedioso; subirlos manualmente uno a uno no era mucho mejor. Así que construí una pequeña CLI que hace 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 alrededor de un vector store. Añades archivos a un store, se procesan en embeddings, y los asistentes (o ChatGPT vía 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 refleja 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 trabajo cron) para mantener tu base de conocimiento actualizada. También hay una opción para incluir metadatos git (branch y commit) en el contenido subido, así cuando ChatGPT cita algo, sabes exactamente de qué versión viene.

Refleja una carpeta local en un Vector Store
Soporta filtrado por extensión (ej., md,txt,pdf)
Metadatos git opcionales (--git-info)
Puede automatizarse 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 pondrá el binario openai-folder-sync en tu PATH.

Usage

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

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

¿Prefieres ejecutar con Cargo durante el desarrollo?

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

La mayoría de flags también pueden establecerse vía 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 – ID del store destino
  --local-dir / LOCAL_DIR – carpeta a sincronizar
  --extensions / EXTENSIONS – lista separada por comas
  --git-info / GIT_INFO – incluir metadatos git (true|false)
  --help – mostrar todas las opciones

How this fits with ChatGPT

Una vez que los archivos están en un vector store, ChatGPT (o tus apps de Assistants API) pueden recuperar fragmentos relevantes de esos archivos mientras responden a tus preguntas. Eso significa que puedes preguntar cosas como “¿Qué decía la propuesta sobre el calendario 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 cuidado. Comienza con los formatos que usas realmente—md, txt, quizá pdf. Esto mantiene el procesamiento rápido y la recuperación enfocada.
Crea primero el vector store. La herramienta espera un ID de store; configúralo vía la API o dashboard, y luego pásalo a la CLI.
Usa la información git para la procedencia. Si sincronizas desde un repo, habilitar –git-info etiqueta el texto subido con metadatos de commit, lo que hace las respuestas más fáciles de confiar y rastrear.
Excluye el ruido. Considera mantener artefactos de build, node_modules, o archivos temporales fuera del directorio sincronizado, o agrégalos a .gitignore si confías en la metadata git.

Example workflow

Crea un vector store por dominio de conocimiento (ej., “Company Wiki”, “Research Notes”).
Apunta openai-folder-sync a la carpeta local correspondiente.
Ejecuta como parte de tu rutina de escritura (para mí: tras 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, simplemente abre un issue o PR.

⸻

Si quieres probarla, el repositorio incluye detalles de instalación, uso y la salida de ayuda. La construí para simplificar mi propio flujo de trabajo; si te ahorra unas cuantas maratones de copiar-pegar y ayuda a ChatGPT a responder desde tus documentos reales, eso es una victoria. ¡Feliz sincronización!