tolvi
Captura decisiones de ingeniería en tiempo real, consulta con lenguaje natural desde CLI o agente IA.
Ficha actualizada 23 sept 2026, 14:40 · upstream 23 sept 2026, 14:08 · release spec-v2.0.0
Qué es tolvi
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Tolvi es una carpeta de conocimiento de ingeniería por repositorio. Almacena decisiones, sesiones y patrones como Markdown con frontmatter YAML bajo <repo>/vault/. Un CLI permite escribir y leerlo desde la terminal; un servidor permite a un equipo compartir una vista indexada. Dos arquitecturas: local (CLI) usa CAG para contexto de Anthropic sin infraestructura adicional, y server (Fastify + Postgres + pgvector) es multi-tenant autocontenido con Docker Compose.
El formato tolvi-format-v2 es el contrato entre ambas ramas y lo único que los agentes necesitan aprender. Tolvi captura en dos alturas: mecánica (CLI) para capturar decisiones conocidas y controladas, y sintetizada (skill) para reconstruir la realidad compleja de una sesión de trabajo.
- Capturar decisiones técnicas durante un sprint o refactorización
- Consultar decisiones pasadas con lenguaje natural desde el CLI
- Integración en agentes de IA como Claude Code, Cursor y Gemini CLI
- Pre-commit nudges que flaggen commits que tocan archivos de decisión
- Automatizar la captura de decisiones durante CI/CD pipelines
- Soporta múltiples arquitecturas: local (CLI) y server (Fastify + Postgres)
- Formato tolvi-format-v2 es el único estándar entre CLI y agentes
- Integraciones con Claude Code, Cursor, Gemini CLI, OpenHands y Aider
- No requiere commit previo de vault para usar la API local
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instala el CLI con `go install github.com/tolvi-labs/tolvi/cli/cmd/tolvi@latest`. Configura tu clave Anthropic en `.env` o `~/.config/tolvi/config.yaml`. Para usar la API server, ejecuta `docker compose up -d` y accede a http://localhost:3000. Instala plugins con `/plugin marketplace add tolvi-labs/tolvi` para añadir capacidades adicionales como codex, cursor, gemini oaider.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.