Comando hermes project — Referência Completa e Exemplos

Visão geral

hermes project gerencia espaços de trabalho nomeados que podem abranger várias pastas ou repositórios. Os projetos ancram o agrupamento de sessões da área de trabalho e, quando vinculados a um quadro kanban, fornecem uma convenção determinística de worktree + branch. O estado do projeto é específico do perfil.

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

Subcomandos

create

Cria um novo projeto.

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

Opções:

• --slug SLUG — slug explícito
• --primary PATH — caminho do repositório principal
• --description DESCRIPTION
• --icon ICON
• --color COLOR
• --board SLUG — vincular um quadro kanban
• --use — definir como projeto ativo

list (ls)

Lista os projetos.

hermes project list
hermes project list --all   # inclui projetos arquivados

show

Exibe os detalhes de um projeto.

hermes project show my-project

add-folder

Adiciona uma pasta a um projeto.

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

remove-folder

Remove uma pasta de um projeto.

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

rename

Renomeia um projeto.

hermes project rename my-project "New Name"

set-primary

Define a pasta principal. O caminho já deve estar no projeto.

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

use

Define o projeto ativo, ou omita o projeto para limpá-lo.

hermes project use my-project
hermes project use          # limpa o projeto ativo

archive

Arquiva um projeto.

hermes project archive old-project

restore

Restaura um projeto arquivado.

hermes project restore old-project

bind-board

Vincula um quadro kanban a um projeto, ou omita o quadro para desvinculá-lo.

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

Cenários comuns

Criar um novo projeto

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

Adicionar pastas de documentação e infraestrutura

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

Trocar o projeto ativo

hermes project list
hermes project use my-saas

Vincular um quadro kanban

hermes project bind-board my-saas roadmap

Arquivar um projeto concluído

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

Dicas

• As definições de projeto são específicas do perfil; perfis diferentes podem ter projetos diferentes.
• A primeira pasta passada para create torna-se a pasta principal, a menos que --primary seja usado.
• Use set-primary quando um projeto tem vários repositórios, mas um deles é o ponto de entrada principal.
• Vincular um quadro dá às tarefas do agente uma convenção determinística de worktree e branch.