Ivy Tendril

La factoría de software agéntico para desarrolladores 10x

Los agentes de IA ahora pueden escribir el 99% del código. Esto cambia lo que significa ser un desarrollador. Nuestro rol pasa a ser saber cómo se ve el código de calidad. Para lograrlo, necesitamos herramientas de desarrollo completamente nuevas. Tendril es esa herramienta y sustituye a tu IDE en la era agéntica.

https://youtu.be/_KVG1NnAj-8

## Características

### Árboles de trabajo paralelos (Parallel Worktrees) Ejecuta agentes en árboles de trabajo aislados de git. Mantén limpia tu rama principal hasta revisar, aprobar y fusionar los cambios. [Documentación →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### Túneles (Tunneling) (Programación remota y móvil) Expón tu servidor de forma segura usando Cloudflare Quick Tunnels para monitorizar y dirigir ejecuciones de agentes desde cualquier lugar. [Documentación →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### Voz y entrada enriquecida (Voice & Rich Input) Dicta prompts usando la entrada de voz integrada de Whisper y adjunta archivos de texto, registros o documentos arrastrando y soltando. [Documentación →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### Anotaciones en planes (Plan Annotations) Anota borradores en línea para actualizar automáticamente los planes con objetivos revisados para el agente. [Documentación →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### Revisiones de código potentes (Code Reviews) Revisa los cambios del agente, inspecciona diferencias y aprueba código con puertas de verificación automatizadas. [Documentación →](https://tendril.ivy.app/docs/gettingstarted/introduction)
### Integración con GitHub y bandeja de entrada automatizada (GitHub Integration & Automated Inbox) Ingiere issues de GitHub o reportes de errores de jam.dev mediante webhooks para convertir planes Markdown en tareas activas automáticamente. [Documentación →](https://tendril.ivy.app/docs/integrations/jamdev)

--- ## Agentes compatibles Funciona con **cualquier agente CLI**: si se ejecuta en una terminal, se ejecuta en Tendril.

Claude Code Codex GitHub Copilot Gemini OpenCode Apple Foundation Models + cualquier agente CLI

## Habilidades de agentes (Agent Skills) Extiende tus agentes de codificación IA favoritos con habilidades oficiales de ingeniería y depuración de Tendril. ### Inicio rápido Instala habilidades de Tendril para cualquier agente compatible usando el instalador universal: ```bash npx skills add ivy-interactive/ivy-tendril ``` O instala una habilidad específica: ```bash npx skills add ivy-interactive/ivy-tendril --skill tendril-debug-plan ``` ### Herramientas y entornos compatibles

Visual Studio Code (GitHub Copilot y extensiones)

Instala habilidades para GitHub Copilot en VS Code: ```bash npx skills add ivy-interactive/ivy-tendril --agent github-copilot ``` Instalación global (en todos los espacios de trabajo): ```bash npx skills add ivy-interactive/ivy-tendril --agent github-copilot -g ``` O copia las habilidades directamente en `.agents/skills/` o `.github/skills/` (a nivel de proyecto) o en `~/.copilot/skills/` (global). Una vez instaladas, las habilidades aparecen en GitHub Copilot Chat bajo el menú `/skills` y se pueden invocar directamente como comandos de barra (por ejemplo, `/tendril-debug-plan`, `/tendril-debug-job`, `/tendril-review`, `/tendrillable`). Extensiones de agentes de terceros para VS Code: - Cline: `npx skills add ivy-interactive/ivy-tendril --agent cline` - Continue: `npx skills add ivy-interactive/ivy-tendril --agent continue` - Roo Code: `npx skills add ivy-interactive/ivy-tendril --agent roo` Para una integración completa en el editor, instala la [extensión oficial de Ivy Tendril para VS Code](https://marketplace.visualstudio.com/items?itemName=ivy-interactive.ivy-tendril) para paneles de planes integrados, navegación por árboles de trabajo y monitoreo de ejecución en vivo. Consulta la [Guía de configuración de VS Code](../vscode-setup.md) para opciones de configuración detalladas.

Claude Code

Instala desde el marketplace de plugins de Claude Code: ``` /plugin marketplace add ivy-interactive/ivy-tendril /plugin install tendril-skills@ivy-tendril ``` Desarrollo local: ```bash claude --plugin-dir /path/to/ivy-tendril ``` Consulta la [Guía de configuración de Claude Code](../claude-setup.md) para opciones detalladas.

Antigravity CLI (agy)

Instala el plugin mediante URL de Git: ```bash agy plugin install https://github.com/ivy-interactive/ivy-tendril.git ``` Instalación local: ```bash agy plugin install ./ ``` Consulta la [Guía de configuración de Antigravity](../antigravity-setup.md) para opciones detalladas.

Cursor

Instalación para Cursor: ```bash npx skills add ivy-interactive/ivy-tendril --agent cursor ``` O copia las habilidades en `.cursor/skills/` (a nivel de proyecto) o en `~/.cursor/skills/` (global). Consulta la [Guía de configuración de Cursor](../cursor-setup.md) para opciones detalladas.

OpenAI Codex

Instala desde el marketplace de plugins de Codex: ```bash codex plugin marketplace add ivy-interactive/ivy-tendril codex plugin add tendril-skills@tendril-skills ```

Gemini CLI

Instala usando la CLI de Gemini: ```bash gemini skills install https://github.com/ivy-interactive/ivy-tendril.git --path skills ```

--- ## Instalación Descarga los instaladores de escritorio independientes (`.pkg`, `.AppImage`, `.exe`) directamente desde [GitHub Releases](https://github.com/Ivy-Interactive/Ivy-Tendril/releases/latest) o ejecuta uno de los siguientes comandos de instalación rápida: **macOS / Linux:** ```bash curl -sSf https://cdn.ivy.app/install-tendril.sh | sh ``` **Windows:** ```powershell irm https://cdn.ivy.app/install-tendril.ps1 | iex ``` ### Ejecución Tendril es una aplicación de escritorio, pero la misma instalación es también una CLI. Son dos binarios separados: `tendril-app` es la aplicación de escritorio y `tendril` es la CLI y el servidor. La aplicación de escritorio se inicia abriendo **Tendril** desde el menú de aplicaciones (o ejecutando directamente el binario `tendril-app`). Iniciar el demonio en modo headless — la API HTTP y WebSocket, sin interfaz gráfica: ```bash tendril run ``` `tendril run` comprueba el puerto y migra la base de datos primero, y después sirve en `127.0.0.1:5010`. Con `--port` / `--host` se puede cambiar eso, y `tendril serve` ofrece el listener puro sin comprobaciones previas (es además el comando que acepta `--tls-cert` / `--tls-key`). Todo lo demás son subcomandos: `tendril --help` los lista todos, y `tendril doctor` informa sobre la instalación (código de salida 0 cuando nada está en `[FAIL]`, 1 en caso contrario, de modo que puede usarse como control en un script). --- ## 🏛 Estructura del directorio ``` Ivy-Tendril-V2/ ├── src/ │ ├── apps/ │ │ ├── tendril-app/ # Aplicación de escritorio Tauri + frontend React │ │ └── tendril-docs/ # Sitio de documentación │ ├── packages/ │ │ └── components/ # @ivy-interactive/components + Storybook │ ├── crates/ │ │ ├── tendril-core/ # Modelos de dominio principales, base de datos SQLite, motor de worktrees │ │ ├── tendril-server/ # Servidor demonio HTTP Axum REST y WebSocket │ │ └── tendril-cli/ # Interfaz de línea de comandos ("tendril") │ ├── extensions/ │ │ └── vscode/ # Extensión para VS Code / Antigravity IDE │ ├── promptwares/ # Definiciones de agentes Promptware y firmware │ ├── skills/ # Habilidades de flujos de trabajo de agentes │ └── scripts/ # Scripts de configuración del repositorio y validación de pruebas ├── docs/ # Contenido de la documentación ├── Cargo.toml # Espacio de trabajo Cargo unificado ├── pnpm-workspace.yaml # Espacio de trabajo pnpm unificado └── package.json # Scripts raíz del espacio de trabajo ``` --- ## 🚀 Primeros pasos ### Requisitos previos - [Rust](https://rustup.rs/) (edición 2021) - [Node.js](https://nodejs.org/) (v22+) y [pnpm](https://pnpm.io/) (v11+) - [Vite+](https://viteplus.dev/) (`vp`) - GitHub CLI (`gh`) ### Inicio rápido 1. **Instalar dependencias**: ```bash pnpm install ``` 2. **Compilar componentes y biblioteca de UI**: ```bash pnpm --filter @ivy-interactive/components build ``` 3. **Iniciar Storybook**: ```bash pnpm dev:storybook ``` 4. **Compilar y ejecutar la aplicación de escritorio**: ```bash pnpm dev:app ``` 5. **Compilar crates del backend**: ```bash cargo build --workspace ``` 6. **Ejecutar pruebas**: ```bash # Pruebas web y de componentes pnpm test # Pruebas de Rust cargo test --workspace ``` ### Pruebas visuales y de capturas de pantalla Para ejecutar las verificaciones de capturas de pantalla y las pruebas visuales de Storybook en local: ```bash pnpm install pnpm run install:playwright:deps ``` --- ## Comunidad y soporte - **Discord:** Únete a la comunidad en **[Discord](https://discord.gg/FHgxkDga3y)**. - **Comentarios e ideas:** ¿Encontraste un error o tienes una idea? [Abre un issue](https://github.com/Ivy-Interactive/Ivy-Tendril/issues). - **Apóyanos:** Dale una [estrella (Star)](https://github.com/Ivy-Interactive/Ivy-Tendril) a este repositorio para seguir nuestro desarrollo. --- ## Licencia Tendril está disponible bajo la licencia [Functional Source License (FSL-1.1-ALv2)](../../LICENSE). Las habilidades y complementos del agente (`skills/`, `.claude-plugin/`, `.codex-plugin/`, `.agents/`) también están licenciados bajo los términos de la raíz del repositorio ([Functional Source License (FSL-1.1-ALv2)](../../LICENSE)).