Comando hermes project — Referencia Completa y Ejemplos

Descripción general

hermes project gestiona espacios de trabajo con nombre propio que pueden abarcar varias carpetas o repositorios. Los proyectos anclan el agrupamiento de sesiones de escritorio y, al vincularse a un tablero kanban, proporcionan una convención determinista de worktree + rama. El estado del proyecto es específico del perfil.

hermes project {create,list,ls,show,add-folder,remove-folder,rename,set-primary,use,archive,restore,bind-board}

Subcomandos

create

Crea un proyecto nuevo.

hermes project create "Hermes Agent" ~/dev/hermes --use

Opciones:

• --slug SLUG — slug explícito
• --primary PATH — ruta del repositorio principal
• --description DESCRIPTION
• --icon ICON
• --color COLOR
• --board SLUG — vincular un tablero kanban
• --use — establecer como proyecto activo

list (ls)

Lista los proyectos.

hermes project list
hermes project list --all   # incluye proyectos archivados

show

Muestra los detalles de un proyecto.

hermes project show my-project

add-folder

Agrega una carpeta a un proyecto.

hermes project add-folder my-project ~/dev/docs --label docs --primary

remove-folder

Elimina una carpeta de un proyecto.

hermes project remove-folder my-project ~/dev/docs

rename

Renombra un proyecto.

hermes project rename my-project "New Name"

set-primary

Establece la carpeta principal. La ruta ya debe estar en el proyecto.

hermes project set-primary my-project ~/dev/hermes

use

Establece el proyecto activo, u omite el proyecto para borrarlo.

hermes project use my-project
hermes project use          # borra el proyecto activo

archive

Archiva un proyecto.

hermes project archive old-project

restore

Restaura un proyecto archivado.

hermes project restore old-project

bind-board

Vincula un tablero kanban a un proyecto, u omite el tablero para desvincularlo.

hermes project bind-board my-project board-slug
hermes project bind-board my-project   # desvincular

Escenarios comunes

Crear un proyecto nuevo

hermes project create "My SaaS" ~/code/api ~/code/web --use

Agregar carpetas de documentación e infraestructura

hermes project add-folder my-saas ~/code/docs --label docs
hermes project add-folder my-saas ~/code/infra --label infra

Cambiar entre proyectos activos

hermes project list
hermes project use my-saas

Vincular un tablero kanban

hermes project bind-board my-saas roadmap

Archivar un proyecto completado

hermes project archive my-saas
hermes project list --all

Consejos

• Las definiciones de proyectos son específicas del perfil; distintos perfiles pueden tener distintos proyectos.
• La primera carpeta que se pasa a create se convierte en la principal, a menos que uses --primary.
• Usa set-primary cuando un proyecto tenga varios repositorios pero uno sea el punto de entrada principal.
• Vincular un tablero da a las tareas del agente una convención determinista de worktree y rama.