Instalación
Descarga la versión más reciente para macOS, Windows o Linux. La aplicación de escritorio incluye el servidor y los runtimes necesarios para operar el canvas.
- Instala al menos una CLI compatible: Claude Code, Codex, Kimi Code, OpenCode, Cursor, Antigravity, Cline o Devin.
- En macOS, usa la versión 0.1.4 o posterior: está firmada con Developer ID y notarizada por Apple, por lo que se abre normalmente desde Finder después de copiarla a Aplicaciones.
- Mantén Git disponible para las funciones de historial, diff y pisos.
- Los modelos locales de voz son opcionales y se descargan solo después de tu confirmación.
Primer workspace
Un workspace apunta a una carpeta real de tu proyecto. Orkestrai mantiene la configuración visual separada y provisiona el puente local que permite a los agentes operar el canvas.
- 1Crea un workspace y selecciona la carpeta del proyecto.
- 2Abre Agentes, elige cualquier servicio disponible y fija hasta cuatro favoritos si quieres acceso directo desde la barra.
- 3Marca un agente como líder para habilitar la orquestación del equipo.
- 4Describe el resultado deseado; el líder puede reclutar especialistas y distribuir tareas.
Canvas y conexiones
El canvas reúne terminales PTY reales, notas, tareas, flujos, imágenes, portales y archivos. Las conexiones representan colaboración real y muestran actividad cuando los agentes conversan.
- Conecta notas e imágenes con sus responsables para hacer explícito el contexto.
- Asigna trabajo en el kanban; cada tarea llega directamente al terminal elegido.
- Abre Portales para ver y probar aplicaciones locales sin salir del workspace.
- Usa Cmd/Ctrl+K para buscar en la documentación dentro de la aplicación.
Workbench y editor
Workbench convierte el mismo workspace en una superficie de escritorio enfocada. El explorador abre agentes, tareas, notas, portales, dispositivos móviles y archivos en hasta ocho paneles redimensionables.
- Elige pestañas verticales u horizontales y divide cualquier panel hacia la derecha o abajo.
- Edita archivos en Monaco con modelos persistentes, búsqueda y reemplazo, símbolos, formato y protección de cambios sin guardar.
- Abre vistas de Markdown, PDF, imágenes y binarios sin crear nodos desconectados en el canvas.
- Usa Cmd/Ctrl+K para buscar archivos, contenido, agentes, tareas, herramientas, configuración y comandos.
Líder y puente Orkestrai
El líder coordina el equipo mediante la CLI orkestrai y las tools MCP provisionadas en el workspace. Puede conversar con agentes, escribir notas, crear tareas, abrir portales y organizar pisos.
orkestrai list
orkestrai ask Frontend "Implementa la pantalla según la nota de especificación"
orkestrai task add "Revisar responsividad" --assign Reviewer
orkestrai notify "Entrega lista para revisión"Flujos y trabajo paralelo
Los flujos encadenan agentes, aprobaciones humanas y salidas reutilizables. Los pisos usan git worktrees para aislar frentes paralelos y mostrar diffs y conflictos antes de aterrizar en la rama principal.
- Sincroniza un flujo con sus conexiones para convertir el dibujo en pipeline.
- Consulta título, etapa y responsable de cada tarea en planta baja y cada worktree.
- Crea un piso por feature cuando varios equipos modifiquen el mismo proyecto en paralelo.
- Revisa la vista previa antes de aterrizar; los conflictos nunca se resuelven silenciosamente.
Dictado y respuestas habladas
El dictado usa Parakeet y las respuestas usan Supertonic 3, ambos localmente. Hay presets para portugués de Brasil, inglés de Estados Unidos y español latinoamericano.
- Enfoca un campo de tarea, rol, nota o formulario y usa la esfera global para insertar el dictado en el cursor.
- Opcionalmente, envía el dictado de la terminal con Enter; los campos de texto comunes permanecen solo para inserción.
- Sin un campo activo en el canvas, la esfera envía la transcripción al líder.
- Elige una voz y ajusta la velocidad entre 0,75x y 1,50x en Configuración.
- La primera descarga requiere confirmación; después, el procesamiento ocurre en el dispositivo.
Operación y continuidad
Los workspaces siguen trabajando en segundo plano. Las sesiones reanudables preservan cada conversación y las notificaciones distinguen tarea completada, proyecto completado y atención.
- Cambia el provider de un agente conservando su rol, piso y conexiones.
- Fija Uso en el canvas y deja que el líder consulte origen, fallback, ventana monitoreada y límite antes de asignar trabajo nuevo.
- Puertos lista únicamente listeners vinculados a Portales locales del workspace actual.
- Elige un tema claro u oscuro listo, o edita y comparte tokens semánticos validados.
- Los datos del canvas, las sesiones y los modelos locales permanecen en tu equipo.
Decisiones, automatización, dispositivos y colaboración
El Centro de Control y el Centro de Revisión hacen explícitas la actividad y las evidencias. Council, Automatizaciones, Dispositivo móvil y el uso compartido cifrado siguen el mismo modelo operativo trazable.
- Solicita perspectivas independientes a entre dos y cinco agentes en Council y conserva la selección final humana.
- Ejecuta automatizaciones idempotentes por agenda, tareas, mensajes, eventos Git, webhooks, archivos o límites de uso.
- Controla iOS Simulator y emuladores Android o dispositivos físicos aprobados desde Canvas y Workbench.
- Elige una invitación para navegador/móvil o app instalada, aprueba el dispositivo y rol exactos y sigue la proyección sanitizada en la PWA Remote instalable.
- Los Operadores pueden conversar con un agente de forma trazable. Los Administradores pueden iniciarlo o restaurarlo; el terminal sin filtrar exige un permiso separado por dispositivo, desactivado por defecto y auditado.