Oh My Rigel

Un fork comunitario de Oh My OpenCode (OmO) que lleva sus funciones al runtime de OpenCode V2.

Qué es Oh My Rigel

Oh My Rigel es una capa de orquestación sobre OpenCode: hereda la orquestación y la delegación de Oh My OpenCode (OmO) y las lleva al runtime de plugins de OpenCode V2. OpenCode se mantiene como dependencia independiente; Rigel no es un fork ni una distribución de OpenCode.

A un programador le aporta planificación, delegación en especialistas, continuidad en tareas largas, herramientas integradas y un flujo más eficaz. Merece la pena si ya trabajas con OpenCode y quieres ese flujo de agentes sin cambiar de host: un asistente único no reparte el trabajo ni conserva el contexto entre sesiones.

Motivo verificable de su creación: llevar el conjunto de funciones de OmO a OpenCode V2 sin recortar superficies (agentes, delegación, skills, permisos, herramientas, contexto y continuidad); la compatibilidad funcional va primero y las mejoras propias llegan después. La funcionalidad de OmO portada a V2 está confirmada; la capa beta adicional (el Juez y las skills del perfil) se pule aparte.

Catálogo

Rigel lleva el conjunto de funciones de OmO a OpenCode V2. En vez de un único asistente que hace de todo, tienes un equipo pequeño que planifica, delega y conserva su propio contexto.

Explora el catálogo completo: cada función y área con detalle.

Relación con Oh My OpenCode

Oh My OpenCode (OmO) es el proyecto padre. Oh My Rigel (OMR) es un fork comunitario que migra las funciones de OmO al runtime de OpenCode V2. OpenCode es el programa anfitrión y se mantiene aparte de OMR. La instalación añade además una capa extra en beta, separada en su propio perfil, que se pulirá más adelante. OMR conserva la atribución al proyecto padre.

Instalar

Instala desde la ruta fuente del repositorio.

La funcionalidad de OmO en OpenCode V2 está completa y confirmada. La instalación añade además una capa externa BETA de agentes (incluido un Juez) y skills del perfil, que se pulirá más adelante.

Instalar con un agente

Copia este prompt y pégalo en un agente (Codex, OpenCode V2 u otro). Está escrito en inglés a propósito y es idéntico en las páginas ES y EN. El agente sigue la guía canónica.

Install and run the Oh My Rigel V2 developer preview from its public source.

Safety requirements:
- Inspect the checkout, AGENTS.md files, repository rules, README.md,
  OH-MY-RIGEL.md, FORK.md, CONTRIBUTING.md, script/agent/setup.sh,
  profiles/gabo/validate-profile.mjs, profiles/gabo/apply-v2-agent-layer.mjs,
  profiles/gabo/switch-live-plugin-to-native-v2.mjs, and
  profiles/gabo/materialize-v2-skills.mjs before changing anything.
- Rigel targets OpenCode V2 only. Detect the installed OpenCode version and
  stop unless it is V2. If OpenCode must be updated, use the current official
  OpenCode installation method and verify the resulting version.
- Confirm that no OpenCode process is running and that this installation will
  not reuse an active V1 installation. Do not create a parallel V1/V2 setup.
- Discover the actual OpenCode V2 config, data, state, cache, plugin, skills,
  and goal-state paths on this machine. Do not assume paths, services,
  credentials, or package managers. Stop and ask for help if ownership or
  isolation is uncertain.
- Never print, copy, or commit credentials or private configuration.

Scope note:
- The Oh My Rigel V2 runtime is the OmO functionality ported to OpenCode V2 and
  confirmed on V2; that ported set is complete.
- The installation additionally includes an external BETA layer of agents
  (including a Judge) and skills from profiles/gabo, which is being polished.
  Keep that extra layer distinct from the confirmed OmO set.

Installation requirements:
1. Use the v2-mirror branch of https://github.com/GaboEI/oh-my-rigel.
2. From the checkout root, run script/agent/setup.sh to verify tools, install
   dependencies, and build.
3. From the checkout root, run node profiles/gabo/validate-profile.mjs.
4. Set RIGEL_V2_HOME to the confirmed V2 home, RIGEL_V2_CONFIG to the absolute
   path of the active V2 JSON config, and RIGEL_V2_USER_ROOT to a dedicated
   Rigel state directory. The variable name RIGEL_V2_LAB_ROOT is a historical
   spelling of that state directory: do not create or require a laboratory or
   service.
5. With those explicit variables, from the checkout root run the user lifecycle
   installer: node profiles/gabo/rigel-v2-user-install.mjs install --version 1.
   It materializes the native runtime and generated agent manifest, exposes the
   V2 skills, and registers the runtime in the selected V2 config. It refuses
   any path that resolves under a V1 root and never launches OpenCode.
6. Verify that the V2 config registers the generated Rigel runtime, launch the
   normal OpenCode V2 command, and confirm that Rigel reports its native V2
   runtime as active. Do not claim unavailable features.

Constraints:
- Do not remove OpenCode V1, the host program, and do not run any destructive
  action without explicit approval from the operator: first report what you
  would do and wait.
- Preserve unrelated and foreign configuration, plugins, skills, and state.
  Only Rigel-owned entries and state may be created, changed, or removed.
- Do not invent commands. Use only the commands in this prompt and the
  canonical guide. If a step is unclear, stop and ask.

Report the detected OpenCode version, resolved non-secret paths, commands run,
checks passed, and remaining limitations. If any safety condition cannot be
demonstrated, do not install or launch anything; explain the blocker and ask
for help.

Copiar no ejecuta nada. Revisa el plan del agente antes de que actúe.

Instalación manual

Ejecuta estos comandos tú mismo, en orden, desde un shell POSIX. Sustituye la ruta de ejemplo por la ruta real de tu configuración de OpenCode V2.

  1. Instala o actualiza OpenCode V2

    Usa el método oficial de instalación de OpenCode V2, confirma que la versión es V2 y cierra todos los procesos de OpenCode antes de continuar.

    Directorio de trabajo cualquier directorio

    curl -fsSL https://opencode.ai/v2/install | bash
    opencode --version
  2. Clona la rama v2-mirror

    Clona el repositorio público y entra en el checkout.

    Directorio de trabajo el directorio donde quieras el checkout

    git clone --branch v2-mirror --single-branch https://github.com/GaboEI/oh-my-rigel.git
    cd oh-my-rigel
  3. Prepara el checkout

    Verifica las herramientas, instala dependencias, compila y valida el perfil.

    Directorio de trabajo la raíz del checkout (oh-my-rigel)

    script/agent/setup.sh
    node profiles/gabo/validate-profile.mjs
  4. Indica tus rutas de OpenCode V2

    Exporta la home V2, la ruta absoluta de tu configuración JSON V2 y un directorio de estado dedicado para Rigel; comprueba que el archivo existe.

    Directorio de trabajo la raíz del checkout (oh-my-rigel)

    export RIGEL_V2_HOME="$HOME"
    export RIGEL_V2_CONFIG="/absolute/path/to/the/active-v2/opencode.json"
    export RIGEL_V2_USER_ROOT="${XDG_DATA_HOME:-$HOME/.local/share}/oh-my-rigel"
    test -f "$RIGEL_V2_CONFIG"
  5. Instala el runtime nativo y arranca

    Instala el runtime nativo V2 y después inicia OpenCode con normalidad.

    Directorio de trabajo la raíz del checkout (oh-my-rigel)

    node profiles/gabo/rigel-v2-user-install.mjs install --version 1
    opencode

GitHub

¿Instalas OpenCode V2 por primera vez? La guía oficial exige retirar OpenCode V1 y sus restos antes de una instalación limpia de V2. OpenCode V1/V2 (el programa anfitrión) y Oh My Rigel V1/V2 (este plugin) son cosas distintas. Guía de migración de OpenCode

Configuración básica

La configuración es declarativa y por capas.

Configuración
~/.omo/omo.jsonc

Configuración de agentes

Revisa el modelo por defecto de cada agente (el Juez de la capa beta no declara ninguno), los criterios de elección y cómo cambiar el modelo de un agente en la guía detallada.

Abrir la guía detallada de modelos, skills y comandos

Agentes, skill y comandos

Agentes: el equipo que planifica, delega y ejecuta tareas. Los agentes OmO del inventario llevan un modelo por defecto y una cadena de respaldo (fallback) cuando se declaran; ese es el detalle de qué IA los ejecuta.

Skill: instrucciones especializadas que amplían cómo trabaja el agente en tareas concretas, sin cambiar el núcleo del producto.

Comandos: acciones invocables para flujos concretos; se ejecutan cuando los necesitas. Cada ficha de la guía detalla qué hace y qué toca.

Ver guía de modelos, skills y comandos

Ciclo de vida del plugin

Verifica el estado, reinstala, actualiza, revierte o desinstala Oh My Rigel sin tocar OpenCode V2 ni plugins ajenos.

Comandos del ciclo de vida

Se ejecutan desde la raíz del checkout. Son las operaciones reales del instalador; ninguna elimina OpenCode V2 ni plugins ajenos.

  1. Estado y salud
    node profiles/gabo/rigel-v2-user-install.mjs status
  2. Reinstalación idempotente
    node profiles/gabo/rigel-v2-user-install.mjs install --version 1
  3. Transición de versión y migración de estado
    node profiles/gabo/rigel-v2-user-install.mjs upgrade --version 2
  4. Reversión byte a byte a la versión previa
    node profiles/gabo/rigel-v2-user-install.mjs rollback
  5. Desinstalación: quita solo el estado de Rigel
    node profiles/gabo/rigel-v2-user-install.mjs uninstall

Estos comandos usan las mismas variables que verificaste en Instalar (RIGEL_V2_HOME, RIGEL_V2_CONFIG y RIGEL_V2_USER_ROOT). Si abres un shell nuevo, vuelve a exportarlas antes de ejecutarlos.

La desinstalación quita solo las entradas y skills de Oh My Rigel; conserva OpenCode V2, tu configuración y otros plugins.

No confundir con la retirada de OpenCode V1 (el anfitrión) para migrar a V2. Guía de migración de OpenCode

Ayuda

Si algo falla: comprueba el estado con el comando de ciclo de vida mostrado arriba, revisa la versión y las rutas de OpenCode (el anfitrión) y sigue la guía del repositorio. No compartas claves ni credenciales en ningún informe.

Incidencias en GitHub (rama v2-mirror)