Saltar a contenido

rai worktree

Gestiona git worktrees de RaiSE. RaiSE hace seguimiento de los worktrees registrados en el registro de misiones para que el contexto de sesión, el enrutado de señales y la recuperación de memoria queden acotados a la rama y story correctas. Un worktree por misión es el patrón recomendado.

Los worktrees viven bajo .worktree/ en la raíz del repositorio principal por convención. No uses la tool EnterWorktree para worktrees de RaiSE — en su lugar, navega manualmente y establece el directorio de trabajo en tu shell o editor.

rai worktree register

Registra un git worktree existente en RaiSE. Vincula el worktree a la misión activa y registra su rama, merge target y claves de story vinculadas.

Argumento Descripción
PATH Ruta del worktree a registrar (requerido)
Flag Corta Descripción
--mission -m ID de misión a la que vincular este worktree
--story -s Clave(s) de story vinculadas a este worktree (repetible)
--merge-target Rama a la que este worktree se fusiona de vuelta. Por defecto: inferida de la config de git
# Registrar el worktree actual
rai worktree register .

# Registrar con vinculación explícita de misión y story
rai worktree register .worktree/raise-commons-auth \
  --mission framework-extensibility \
  --story RAISE-1234

rai worktree context

Muestra el registro de contexto completo de un worktree registrado — rama, misión vinculada, claves de story, merge target e historial de sesiones.

Argumento Descripción
PATH Ruta del worktree (opcional — por defecto el directorio actual)
rai worktree context
rai worktree context .worktree/raise-commons-auth

rai worktree complete

Marca un worktree registrado como completado. Actualiza el estado del worktree en el registro de misiones. No elimina el worktree.

Argumento Descripción
PATH Ruta del worktree (opcional — por defecto el directorio actual)
rai worktree complete
rai worktree complete .worktree/raise-commons-auth

rai worktree list

Lista todos los worktrees registrados y su estado actual.

Flag Corta Descripción
--format -f Formato de salida: human, json. Por defecto: human
--mission -m Filtrar por ID de misión
rai worktree list
rai worktree list --mission framework-extensibility
rai worktree list --format json

Ver también: rai session