Saltar al contenido
Volver al inicio

Documentación del producto

Empieza con un agente. Termina con un equipo.

Una guía directa para instalar Orkestrai, construir el canvas y entregar trabajo con agentes que comparten contexto.

01 / 09

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.
02 / 09

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.

Paso a paso
  1. 1Crea un workspace y selecciona la carpeta del proyecto.
  2. 2Abre Agentes, elige cualquier servicio disponible y fija hasta cuatro favoritos si quieres acceso directo desde la barra.
  3. 3Marca un agente como líder para habilitar la orquestación del equipo.
  4. 4Describe el resultado deseado; el líder puede reclutar especialistas y distribuir tareas.
03 / 09

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.
04 / 09

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.
05 / 09

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"
06 / 09

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.
07 / 09

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.
08 / 09

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.
09 / 09

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.