Comandos de sesión

VelaTerm añade un conjunto de comandos breves a cada sesión que inicia. Usted y sus agentes los usan para iniciar otras sesiones, abrir archivos, leer otras conversaciones y buscar en ellas, comprobar qué sesiones están ocupadas, enviar mensajes entre sesiones y esperar a que terminen comandos largos. Este capítulo es una referencia de cada comando y de las habilidades de agente correspondientes.

1. Dónde funcionan los comandos

Los comandos están en el PATH de todas las sesiones que inicia VelaTerm: terminales normales y sesiones de agente, tanto en la vista de terminal como en la vista de conversación, incluidas las sesiones de un servidor VelaTerm remoto. No requieren instalación. Fuera de estas sesiones, terminan con el mensaje «not inside a VelaTerm session».

Ejecute un comando con --help para ver cómo se usa.

Varios comandos admiten una referencia de sesión: un ID de sesión completo, un prefijo de ID de al menos 8 caracteres, el nombre exacto de la sesión o una parte del nombre que la identifique de forma única. Escriba entre comillas los nombres que contienen espacios. Cuando una referencia coincide con varias sesiones, el comando enumera las candidatas.

2. Habilidades de agente (Vela Skills)

Ajustes ▸ General ▸ «Vela Skills» instala las habilidades correspondientes en Claude Code y Codex; «Reinstall» las actualiza. Después, inicie una conversación nueva de Claude o Codex para que el agente las cargue. En Claude Code, una habilidad se invoca con /name; en Codex, con $name.

Las habilidades marcadas con «Usted» solo se ejecutan cuando usted las invoca; las demás también puede usarlas el agente por iniciativa propia cuando usted menciona otra sesión o un trabajo anterior. vask solo existe como habilidad; ejecuta vrefer <session> --ask "<question>".

3. vspawn y vspawn-tree

vspawn [--worktree] [--cwd <path>] [--yes] [--claude|--codex|--copilot|--kiro] [--model <name>] [--effort <level>] <task description...>

Inicia una sesión nueva debajo de la actual y le envía la tarea como primer mensaje. vspawn-tree es el mismo comando con un worktree de git independiente.

Más información: Creación de sesiones y colaboración en Git y Planificación y ejecución.

4. vopen

vopen <file|url>...

Abre cada argumento en el panel central. Los archivos Markdown se abren en el editor Markdown; las imágenes, en el visor de imágenes, y los demás archivos, en el editor de código. Las direcciones web (http o https) se abren en una pestaña de navegador, disponible solo en la aplicación de escritorio. Las rutas relativas se resuelven respecto al directorio actual. Consulte Pestañas de documentos y navegador.

5. vrefer y vask

vrefer <session> [--last N] [--range A:B] [--json]
vrefer <session> --ask "<question>" [--with <agent>] [--timeout N]
vrefer --list [--json]

Imprime la conversación de otra sesión. No es necesario que la otra sesión esté en ejecución, y no se le envía nada.

--ask inicia un proceso de agente independiente para obtener la respuesta y solo devuelve esa respuesta, de modo que una conversación larga no llena el contexto actual. Ajustes ▸ Comportamiento ▸ «Contexto de referencias de sesión» determina cómo se entrega la conversación al agente que responde: «Transcripción completa» (predeterminado) o «Resumir primero», que antes la condensa con el «Agente de resumen», el modelo y el esfuerzo elegidos allí. Si no se puede obtener una respuesta, vrefer explica el motivo e imprime la conversación en su lugar.

Se pueden leer las conversaciones de Claude Code, Codex, OpenCode, Pi, OMP, Grok Build y Kiro (solo registros de texto). No se pueden leer otros tipos de sesión ni las sesiones cuya conversación de agente aún no se ha registrado.

6. vsearch

vsearch <words...> [--session <session>] [--all|--archived] [--limit N] [--json]

Busca en las conversaciones de todas las sesiones del VelaTerm conectado. Todas las palabras deben coincidir, en cualquier orden.

Cada resultado muestra el nombre de la sesión, su prefijo de ID, el número de coincidencias, algunos fragmentos con sus números de mensaje y el comando vrefer que lee la conversación completa. Un número de mensaje se puede usar con vrefer --range. Los resultados proceden únicamente de las conversaciones de los agentes; no se devuelven las coincidencias que solo existen en grabaciones de terminal. «no matches» es un resultado normal.

7. vstat

vstat [--wait] [--follow] [--timeout N] [--json]

Muestra el estado de cada sesión: working (trabajando), asking (a la espera de un permiso o una respuesta), waiting (ha terminado su turno) o unknown (desconocido). El estado refleja la actividad, no si se ha completado una tarea.

Un primer argumento opcional filtra por un ID de orquestación de versiones anteriores de VelaTerm; los flujos de trabajo de planificación y ejecución usan vflow status en su lugar.

8. vtell

vtell <session> [--steer] [--message-id msg-UUID] [message...]
vtell [planner-session] --report --round N [--message-id msg-UUID] [message...]

Envía un mensaje a otra sesión. Si no se pasan argumentos de mensaje, el texto se lee de la entrada estándar. El destinatario ve en su conversación el icono del agente remitente y el nombre de la sesión, también después de volver a abrirla.

• El destinatario debe ser una sesión de Claude Code, Codex, OpenCode, Pi u OMP en la vista de conversación. Se rechazan las sesiones archivadas y la propia sesión remitente.
• Si el destinatario está inactivo, inicia un turno nuevo. Si está ocupado, el mensaje queda en cola hasta que termina su turno; --steer, en cambio, lo añade al turno en curso.
• Un mensaje puede contener hasta 65 536 bytes de texto.
• El comando imprime un acuse de recibo: sent, queued o steered. blocked significa que el destinatario está esperando un permiso o una respuesta. El acuse confirma la entrega, no que el destinatario haya terminado el trabajo.
• El comando imprime un ID de mensaje. Para reintentar una entrega cuyo resultado es incierto, repita el comando con --message-id y el mismo texto; el mensaje no se entrega dos veces.
• Las sesiones de ejecución de un flujo de trabajo de planificación y ejecución usan --report --round N para enviar su resultado a revisión. El informe llega a la sesión de planificación de esa sesión de ejecución. Consulte Planificación y ejecución.

9. vrun

vrun [-t <seconds>] <label> <command> [arguments...]
vrun --status <label>

Inicia un comando, espera a que termine y, después, imprime el código de salida, el tiempo transcurrido y el final de su registro. El código de salida del comando se devuelve sin cambios. vrun está pensado para compilaciones y pruebas largas: un agente que las ejecuta con vrun conoce el resultado en cuanto está disponible.

• -t <seconds> establece cuánto tiempo espera vrun (1800 de forma predeterminada). Cuando se agota el tiempo, vrun termina con el código 124 y el comando sigue ejecutándose.
• --status <label> informa sobre un comando iniciado anteriormente con esa etiqueta.
• Mientras se ejecuta un comando, la sesión sigue figurando como en curso. En la vista de terminal, una fila «Comandos en segundo plano» situada encima del terminal enumera los comandos en ejecución con «Registro» y «Detener»; consulte Uso del terminal §6.1.

10. vkb

vkb explore <query> | search <query> | node <symbol-id> | callers <id> [depth] | callees <id> [depth]
    | impact <id> [depth] | path <from-id> <to-id> | files [path]
    | memories <query> | memory <entry-id> | notes <query> | note <vault-id> <path> | status

Consulta el grafo de código de la copia de trabajo actual y la base de conocimientos del VelaTerm conectado. Las consultas de código requieren que la indexación esté activada en la página Grafo de código del proyecto. vkb solo lee; no modifica ningún artículo de conocimiento. Consulte Grafo de código y base de conocimientos, Base de conocimientos de sesiones y Bases de conocimientos locales.

11. vflow

vflow status|stop|propose|dispatch|accept|block <workflow-id> [--round N --message-id msg-UUID] < message.txt

Controla los flujos de trabajo de planificación y ejecución. La sesión de planificación usa propose, dispatch, accept y block como parte del flujo de trabajo. Normalmente, usted solo necesitará dos acciones:

• vflow status <workflow-id> muestra el estado del flujo de trabajo, sus tareas, sus sesiones y la ronda actual.
• vflow stop <workflow-id> detiene las rondas siguientes y pide a las sesiones en ejecución que se detengan.

12. El comando vela

En macOS, Ajustes ▸ General ▸ «Comando de shell» ofrece «Instalar el comando ‘vela’». Esta opción añade vela <project-path> a su shell, de forma similar al comando code de VS Code. Al ejecutarlo en cualquier terminal, el proyecto se abre en VelaTerm o, si ya está abierto, VelaTerm cambia a él. VelaTerm no sobrescribe un comando vela existente que no haya instalado él mismo.