Cómo funcionan los comandos

Lo único que debes saber: OpenSpec tiene dos tipos de comandos, y se ejecutan en dos lugares diferentes.

• Los comandos openspec ... se ejecutan en tu terminal. (Ejemplo: openspec init.)
• Los comandos /opsx:... se ejecutan en el chat de tu asistente de IA. (Ejemplo: /opsx:propose.)

Si alguna vez escribes /opsx:propose en tu terminal y no sucede nada, esta página te explica por qué. Te estás dirigiendo a la mitad equivocada de OpenSpec. Los comandos con barra diagonal no son comandos de terminal. Son instrucciones que le das a tu asistente de código con IA, en el mismo cuadro de chat donde normalmente escribirías "añade un formulario de inicio de sesión".

Esa distinción es el obstáculo más común para los usuarios nuevos, así que vamos a dejarlo perfectamente claro.

Las dos mitades

OpenSpec es un solo proyecto que usa dos sombreros.

La CLI (la mitad de terminal). Un programa llamado openspec que instalas y ejecutas desde tu shell. Configura tu proyecto, lista y valida cambios, muestra un panel de control y archiva el trabajo terminado. Escribes estos comandos en iTerm, la terminal de VS Code, PowerShell, en cualquier lugar donde ejecutarías git o npm.

openspec init        # configura OpenSpec en este proyecto
openspec list        # ver cambios activos
openspec view        # abrir el panel de control interactivo

Los comandos con barra diagonal (la mitad de chat). Comandos cortos como /opsx:propose y /opsx:apply que escribes en tu asistente de IA. Estos le indican a la IA que siga el flujo de trabajo de OpenSpec: redactar una propuesta, escribir especificaciones, construir a partir de la lista de tareas y archivar cuando termine. Escribes estos en Claude Code, Cursor, Devin Desktop, Copilot o el asistente que uses.

/opsx:propose add-dark-mode    (escrito en tu chat de IA)
/opsx:apply                    (escrito en tu chat de IA)
/opsx:archive                  (escrito en tu chat de IA)

Aquí está el modelo mental en una sola imagen:

        TU TERMINAL                         CHAT DE TU ASISTENTE DE IA
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   instala     │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   comandos    │  /opsx:archive                │
   └──────────────────────┘    y skills   └──────────────────────────────┘
        ejecuta openspec aquí                       ejecuta /opsx:* aquí

Fíjate en la flecha. Ejecutar openspec init en tu terminal es lo que instala los comandos con barra diagonal en tu herramienta de IA. La mitad de terminal configura la mitad de chat. Después de eso, el uso diario ocurre principalmente en el chat.

"¿Cómo inicio el modo interactivo?"

No hay un modo interactivo separado que iniciar. Esta pregunta surge mucho, así que merece una respuesta clara.

No entras en un modo especial de OpenSpec. Simplemente abres tu asistente de código con IA como siempre lo haces y escribes un comando con barra diagonal en el chat. El comando con barra diagonal es la forma en que "entras" en OpenSpec. Tu asistente lo reconoce, carga la skill de OpenSpec correspondiente y comienza a seguir el flujo de trabajo.

Así que las instrucciones reales son:

1. Abre tu asistente de código con IA (Claude Code, Cursor, Devin Desktop, etc.) en tu proyecto.
2. Escribe /opsx:propose en su chat, en el mismo lugar donde escribes cualquier otra solicitud.
3. Observa la autocompletación: si OpenSpec está instalado, verás /opsx:propose, /opsx:apply y otros aparecer mientras escribes la barra diagonal.

Eso es todo. No hay modo que activar, no hay demonio que lanzar, no hay ventana separada.

Una cosa que sí es genuinamente interactiva vive en la terminal: openspec view. Abre un panel de control para navegar tus especificaciones y cambios. Pero eso es un visor, no la herramienta con la que propones y construyes. La construcción se hace a través de comandos con barra diagonal en el chat.

Por qué existe esta división

Vale la pena entenderlo, porque explica por qué OpenSpec funciona con más de 30 herramientas de IA diferentes.

La CLI es el motor. Conoce las reglas: cómo se ve una carpeta de cambios, qué artefactos dependen de cuáles, cómo fusionar una especificación delta en tu fuente de verdad. Es la misma en todas partes.

Los comandos con barra diagonal son el volante, y cada herramienta de IA tiene uno ligeramente diferente. Claude Code los llama comandos. Cursor y Devin Desktop tienen sus propios formatos. Algunas herramientas los llaman skills. Cuando ejecutas openspec init, OpenSpec genera el tipo de archivo correcto para cada herramienta que seleccionaste, de modo que la misma intención de /opsx:propose funcione sin importar qué asistente prefieras.

La fortaleza de este diseño: aprendes el flujo de trabajo una vez y lo llevas a través de herramientas. El contrapunto: la sintaxis exacta de un comando puede variar ligeramente entre herramientas, que es el tema de la siguiente sección.

Sintaxis de comandos con barra diagonal por herramienta

La intención es idéntica en todas partes. La forma de escribirlo sigue el archivo que tu herramienta carga.

Archivo de comandos de tu herramienta	Cómo lo escribes	Herramientas de ejemplo
.../commands/opsx/<id>.*	/opsx:propose	Claude Code, Gemini CLI, Crush
.../opsx-<id>.*	/opsx-propose	Cursor, GitHub Copilot (IDE), Devin Desktop, Trae, Oh My Pi
.amazonq/prompts/opsx-<id>.md	@opsx-propose	Amazon Q Developer
ninguno — solo skills	/openspec-propose	CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, .agents compartido
ninguno — Kimi Code	/skill:openspec-propose	Kimi Code
ninguno — Codex CLI	$openspec-propose	Codex

Devin es la única herramienta que abarca dos filas. Devin Desktop lee .devin/workflows/, por lo que /opsx-propose funciona allí; Devin Local no lo hace, así que en ese agente usa la skill /openspec-propose en su lugar. Las skills que OpenSpec escribe en .devin/skills/ funcionan en ambos, por eso se refieren entre sí por nombre de skill.

Cada herramienta está listada en Cómo Invocar — esa tabla es la autoritativa. Dos filas no son comandos con barra diagonal en absoluto: Amazon Q carga sus archivos en una biblioteca de prompts invocada con @, y las tres últimas filas usan el nombre de skill, que no es el id del comando (/opsx:apply es la skill openspec-apply-change).

Cuando tengas dudas, lee la línea "Getting started" que imprime openspec init: ya usa la forma que tus herramientas registraron. Escribir una barra diagonal y observar la autocompletación también funciona, para las herramientas que muestran comandos con barra diagonal.

Cómo llegaron los comandos: skills y comandos

Cuando ejecutas openspec init (o openspec update), OpenSpec escribe archivos pequeños en tu proyecto para que tu herramienta de IA pueda encontrar el flujo de trabajo. Dependiendo de tu herramienta y configuración, estos son skills, comandos o ambos.

• Las skills viven en lugares como .claude/skills/openspec-*/SKILL.md. Son el estándar emergente entre herramientas: una carpeta de instrucciones que tu asistente detecta automáticamente.
• Los comandos viven en lugares como .cursor/commands/opsx-<id>.md o .claude/commands/opsx/<id>.md — el esquema es de la herramienta, y ella decide cómo escribes el comando. Son los archivos más antiguos de comandos con barra diagonal por herramienta. Codex no recibe archivos de comandos generados; usa .agents/skills/openspec-*.

No tienes que preocuparte por cuál usa tu herramienta. Simplemente escribes el comando con barra diagonal y funciona. Pero saber que estos archivos existen ayuda cuando algo sale mal: si tus comandos desaparecen, generalmente significa que estos archivos faltan o están desactualizados, y openspec update los regenera.

Consulta Herramientas Soportadas para las rutas exactas por herramienta, y Guía de Migración para cómo las skills reemplazaron el enfoque anterior de solo comandos.

Confirmar que está instalado

Verificaciones rápidas, de la más rápida a la más lenta:

1. Escribe una barra diagonal en tu chat de IA. Comienza a escribir /opsx y observa las sugerencias de autocompletación. Si aparecen, estás listo. En una herramienta solo con skills (Codex, Kimi Code, CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, o el destino .agents compartido) /opsx nunca se completa ni con una instalación sana — prueba el nombre de skill de la tabla anterior en su lugar.
2. Busca los archivos. Para Claude Code, verifica que .claude/skills/ contenga carpetas openspec-*. Otras herramientas usan sus propios directorios (Herramientas Soportadas los lista).
3. Vuelve a ejecutar la configuración. Desde la raíz de tu proyecto, ejecuta openspec update. Esto regenera los archivos de skills y comandos para las herramientas que configuraste.
4. Reinicia tu asistente. Muchas herramientas escanean skills y comandos al iniciar, así que una ventana nueva puede ser el paso faltante.

¿Qué comandos tengo siquiera?

Por defecto, OpenSpec instala el conjunto núcleo de comandos con barra diagonal:

• /opsx:explore: reflexiona sobre una idea con la IA antes de comprometerte con un cambio (excelente primer paso cuando tienes dudas)
• /opsx:propose: crea un cambio y redacta todos sus artefactos de planificación en un solo paso
• /opsx:apply: construye el cambio trabajando a través de su lista de tareas
• /opsx:update: revisa los artefactos de planificación de un cambio y los mantiene coherentes
• /opsx:sync: fusiona las actualizaciones de especificaciones de un cambio en tus especificaciones principales (generalmente automático)
• /opsx:archive: finaliza un cambio y lo archiva

Un ritmo por defecto recomendable: explore cuando estás figuring out qué hacer, luego propose, apply, archive. La guía Explora Primero explica por qué ese paso inicial vale la pena.

También hay un conjunto expandido para quienes quieren un control más fino (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard). Lo activas con openspec config profile y luego lo aplicas con openspec update.

¿Nuevo en todo esto? /opsx:onboard (en el conjunto expandido) te guía a través de un cambio completo en tu propia base de código, narrando cada paso. Es la introducción más amigable posible.

Para lo que hace cada comando en detalle, consulta Comandos. Para cuándo usar cuál, consulta Flujos de Trabajo.

Una primera ejecución limpia

Poniéndolo todo junto, aquí está la secuencia completa con cada paso etiquetado según dónde ocurre.

TERMINAL   $ npm install -g @fission-ai/openspec@latest
TERMINAL   $ cd your-project
TERMINAL   $ openspec init
              (instala comandos con barra diagonal en tu herramienta de IA)

CHAT DE IA   /opsx:explore
              (opcional: reflexiona la idea con la IA primero)

CHAT DE IA   /opsx:propose add-dark-mode
              (la IA redacta propuesta, especificaciones, diseño, tareas)

CHAT DE IA   /opsx:apply
              (la IA lo construye, marcando tareas completadas)

CHAT DE IA   /opsx:archive
              (el cambio se fusiona en tus especificaciones y se archiva)

Dos pasos en terminal para configurar. Luego vives en el chat. Ese es el ritmo.

Relacionado

• Primeros Pasos: la guía completa del primer cambio
• Comandos: cada comando con barra diagonal en detalle
• CLI: cada comando de terminal en detalle
• Herramientas Soportadas: sintaxis y ubicaciones de archivos por herramienta
• Preguntas Frecuentes: más respuestas rápidas
• Solución de Problemas: soluciones cuando los comandos no aparecen