Bienvenido a Orchemax

Orchemax es el runtime local que permite que varios agentes de código trabajen en tus proyectos sin destrozar el repositorio.

Qué es Orchemax#

• Un solo binario local, orch, que corre por debajo de los CLI de agentes que ya usas: Claude, OpenCode, Codex, Cursor, Copilot y los demás.
• Elige un Chair por proyecto (el primer asiento interactivo) y deja que ese Chair lance workers para las tareas secundarias.
• Pone la memoria del taller en disco — ledger, board, resume, ficha de la última sesión — en vez de dejarla en un chat que termina cuando se cierra la ventana.
• Aplica la ley del código compartido: locks sobre las carpetas compartidas, orch:export como contrato de publicación, y un índice de símbolos que cualquier agente puede consultar antes de escribir un duplicado.
• Puede enrutar el tráfico de modelos por un gateway local que guarda tus llaves de proveedor, las rota y comprime los payloads antes de que salgan de la máquina.

Qué no es Orchemax#

• No es un chat ni un IDE de reemplazo. Sigues escribiendo tu prompt dentro de la interfaz del propio agente. orch claude abre Claude; no lo envuelve en otra interfaz.
• No es un servicio en la nube al que haya que sumarse. Vincular un workspace al overlook de Orchemax es opcional; un taller sin vincular sigue funcionando sin conexión.
• No es un proveedor de modelos. Orchemax no trae ningún LLM propio. Tú pones las llaves, o el agente usa el login de su propio plan.
• No es un mandato. Los documentos de doctrina sembrados, los guards y los hooks son opt-in. Tu propio proceso gana si lo prefieres.

Cómo encajan las piezas#

  tu terminal
      |
      |  orch claude / orch codex / orch opencode ...
      v
  +--------------------------------------------------+
  |  orch (runtime local)                             |
  |    Chair  --dispatch_worker-->  worker  worker    |
  |    locks | símbolos | bus | memoria | gateway     |
  +--------------------------------------------------+
      |                                    |
      v                                    v
  tu workspace en disco             tus proveedores de modelos
  (orch.yaml + .orch/)              (las llaves quedan locales)

Equipo y automatización#

Una vez que un asiento funciona, esto convierte un taller en algo que un equipo puede correr y conectar al resto de su tooling — cada item de aquí salió con un test unitario y una prueba con un agente real:

• Notificaciones y aprobaciones — un webhook firmado al sellar y al promover, Telegram avisos suaves (Professional+), y Assist HITL SaaS desde Team.
• Horarios de trabajo Team — zona de la empresa y ventanas On/Off/Ignored por día que controlan el despacho Team en lenguaje claro (sin el molde críptico plan deny).
• Ajustes comunes del asiento — UI de terminal que maneja Orchemax, allowlists MCP/tools del vendor, asientos con login/plan (sin API key), modelo de OpenClaude, dontAsk vs bypassPermissions, Notification.
• Presencia en la bandeja — icono que abre orch ui, mira gateway/workers/HITL y puentea toasts de escritorio.
• Entérate cuando un worker termina o pregunta — una notificación de escritorio con sonido por tipo de evento, el hook propio de Claude Code al detenerse, y un /answer por Telegram cuando la pregunta de un worker necesita un humano.
• Webhooks entrantes — un receptor local, firmado con HMAC, que n8n o Zapier pueden llamar para crear y despachar una tarea.
• Revisión cruzada entre proveedores — un CLI escribe, el CLI de otro proveedor revisa solo lectura antes de promover.
• Los principios que siembra Orchemax, y cómo agregar los tuyos — la capa por defecto de nueve líneas, cuáles verifica un gate de verdad, y tu propia capa encima.
• Protocolo silencioso del seat vs archivos del workshop — inyección SessionStart / .orch/ORCH_RUNTIME.md vs archivos que editas; sin */skills/orch-* públicos por defecto (escape ORCH_LEGACY_SKILLS=1).
• Mismo CLI, varios proyectos — --name + to_project cuando varios Chairs comparten un binario.
• Agrega tu lenguaje — una semilla en .orch/langs/ para que el índice lea un lenguaje que este build no trae, y el PR que se lo da a todo el mundo.
• Tus propias reglas y Packs, bitácora de auditoría y política — gates y skills que copias, editas y puedes auditar después.
• Paquete de evidencia — un artefacto por sesión: veredicto, archivos, comandos, tests, tokens — adjuntable a un PR.
• Programación consciente de recursos — encola un despacho en vez de amontonarse sobre un host cargado; míralo en orch status.
• Limpieza y re-setup — inventaria y elimina lo que Orchemax o un agente dejó en un workspace, vuelve a sembrarlo desde un estado conocido, o desinstala Orchemax por completo con orch uninstall.
• El modo plan y las llaves de gateway por worker están en Chair y workers y Gateway y overlook; la búsqueda de texto completo en memoria en Memoria en disco; los presupuestos diarios de tokens en Ver mi consumo y mis fugas; AGENTS.md como el único archivo de instrucciones que lee cada CLI en Configura agentes.

A dónde ir ahora#

• Instalación — copia a %LOCALAPPDATA%\Programs\orch (Windows) o ~/.local/bin (macOS/Linux), luego PATH + machine home.
• Inicio rápido — vincula un workspace, siémbralo, abre el primer asiento, corre el primer worker.
• Qué leer después — la ruta que corresponde a lo que viniste a hacer.
• Versión 0.7.0 — vista previa, acceso anticipado por invitación: un ensayo nocturno, compuertas de sello acotadas a lo que alcanza un cambio, lecciones a prueba, adaptadores de pruebas por lenguaje, una guarda de publicación que falla cerrada.
• Versión 0.6.0 — vista previa, acceso anticipado por invitación: un inicio con resumen real, un cierre que guarda mientras trabajas, una línea de progreso en vivo, avisos más discretos.
• Versión 0.5.0 — vista previa, acceso anticipado por invitación: compuertas en el momento de la acción, ciclo de mejora, huella que se recorta sola.
• Versión 0.4.0 — novedades: lecciones base, sellos rápidos, orch land, planificador de capacidad, un solo binario.