Comando hermes profile — Referência Completa e Exemplos

Visão Geral

hermes profile gerencia múltiplas instâncias isoladas do Hermes. Cada perfil tem sua própria configuração, sessões, skills, memória e credenciais, armazenados em ~/.hermes/profiles/<nome>/. O perfil default sempre existe.

Use a flag global --profile <nome> (ou -p) para executar um único comando em outro perfil sem alterar o padrão.

hermes profile <subcomando>

Subcomandos

list

Listar todos os perfis.

hermes profile list

use <nome>

Definir o perfil padrão.

hermes profile use work

create <nome>

Criar um novo perfil. O nome deve ser alfanumérico e em minúsculas.

hermes profile create work [--clone] [--clone-all] [--clone-from SOURCE] [--no-alias] [--no-skills] [--description "Trabalho backend"]

Flags:

• --clone — Copiar config.yaml, .env, SOUL.md e skills do perfil ativo.
• --clone-all — Cópia completa do perfil ativo (exceto histórico próprio do perfil).
• --clone-from SOURCE — Copiar de um perfil origem específico (implica --clone, a menos que --clone-all seja usado).
• --no-alias — Não criar o script wrapper.
• --no-skills — Criar um perfil vazio sem skills empacotadas.
• --description — Descrição de uma ou duas frases, usada pelo decomposer do kanban.

delete <nome>

Excluir um perfil e todos os seus dados.

hermes profile delete old-project [-y]

describe [nome]

Ler ou definir a descrição de um perfil.

hermes profile describe work --text "Perfil de trabalho backend"
hermes profile describe --auto --all

Flags:

• --text TEXT — Definir a descrição como texto exato.
• --auto — Gerar descrição automaticamente via o LLM auxiliar.
• --overwrite — Com --auto, substituir descrições existentes também.
• --all — Com --auto, executar em todos os perfis sem descrição.

show <nome>

Mostrar detalhes do perfil.

hermes profile show work

alias <profile_name>

Gerenciar scripts wrapper para um perfil.

hermes profile alias work [--name work-hermes]
hermes profile alias work --remove

rename <antigo> <novo>

Renomear um perfil.

hermes profile rename work company-x

export <nome>

Exportar um perfil para um arquivo .tar.gz.

hermes profile export work -o work.tar.gz

import <arquivo>

Importar um perfil de um arquivo .tar.gz.

hermes profile import work.tar.gz [--name work]

install <origem>

Instalar uma distribuição de perfil do Hermes a partir de uma URL git (por exemplo github.com/usuario/repo, https://..., git@...) ou um diretório local contendo distribution.yaml na raiz.

hermes profile install https://github.com/org/profile-dist [--name work] [--alias] [--force] [-y]

Flags:

• --name NAME — Sobrescrever o nome do perfil no manifesto.
• --alias — Criar um alias wrapper no shell.
• --force — Sobrescrever um perfil existente com o mesmo nome (dados do usuário preservados).
• -y — Pular a confirmação de pré-visualização do manifesto.

update <nome>

Refazer o pull da distribuição a partir da fonte registrada e aplicar atualizações. Dados do usuário (memórias, sessões, auth, .env) são preservados; config.yaml também é preservado, a menos que --force-config seja usado.

hermes profile update work [--force-config] [-y]

info <nome>

Mostrar o manifesto da distribuição de um perfil (versão, requisitos, origem).

hermes profile info work

Exemplos

# Criar e alternar para o perfil de trabalho
hermes profile create work --description "Trabalho backend"
hermes profile use work

# Comando pontual em outro perfil sem alterar o padrão
hermes --profile personal chat -q "Planeje meu fim de semana"

# Exportar e depois reimportar um perfil
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name work-restored

# Instalar uma distribuição de perfil compartilhada pelo time
hermes profile install [email protected]:org/team-hermes-profile --alias -y

# Atualizar um perfil baseado em distribuição
hermes profile update team-profile -y

Dicas

• Perfis são completamente isolados: configurações, sessões, credenciais e memória não se misturam.
• Use hermes --profile <nome> ... para chamadas pontuais sem mudar o perfil padrão.
• describe --auto --all é útil antes de usar o kanban, pois o decomposer usa as descrições para rotear tarefas.
• Instalações de distribuição (install/update) preservam dados do usuário e, por padrão, só sobrescrevem arquivos pertencentes à distribuição.