Importar de outros agentes

O hermes import-agent traz sua configuração existente do Claude Code ou do OpenAI Codex CLI para o Hermes, com um comando só. Ele segue o mesmo padrão de mostrar antes de aplicar do hermes claw migrate: você sempre vê um plano item a item antes de qualquer escrita, e o --dry-run nunca toca no disco.

hermes import-agent                    # detecta ~/.claude ou ~/.codex sozinho
hermes import-agent claude-code        # importa de ~/.claude
hermes import-agent codex              # importa de ~/.codex
hermes import-agent claude-code --dry-run          # só a prévia
hermes import-agent codex --source /caminho/para/.codex # local personalizado
hermes import-agent claude-code --overwrite --yes  # substitui conflitos, sem perguntar

O que é importado

Claude Code (~/.claude)

Claude Code	Hermes
CLAUDE.md (instruções globais)	Entradas de memória em ~/.hermes/memories/MEMORY.md
settings.json → permissions.allow (regras Bash(...))	command_allowlist no config.yaml
settings.json → permissions.deny (regras Bash(...))	approvals.deny no config.yaml
mcpServers (de ~/.claude.json e do settings.json)	mcp_servers no config.yaml
skills/<nome>/ (diretórios com SKILL.md)	~/.hermes/skills/claude-code-imports/<nome>/
commands/*.md (comandos de barra)	Pulados, com uma nota — converta em skills

As regras de prefixo do Claude, como Bash(npm run test:*), viram globs npm run test*. Regras de permissão que não são de Bash (Read(...), WebFetch etc.) controlam ferramentas específicas do Claude e são reportadas como não mapeadas, em vez de importadas.

Codex CLI (~/.codex)

Codex CLI	Hermes
AGENTS.md (instruções globais)	Entradas de memória em ~/.hermes/memories/MEMORY.md
config.toml → [mcp_servers.*]	mcp_servers no config.yaml
memories/*.md	Entradas de memória em ~/.hermes/memories/MEMORY.md
skills/<nome>/ (diretórios com SKILL.md)	~/.hermes/skills/codex-imports/<nome>/

O que nunca é importado

Chaves de API e credenciais. Arquivos de credencial (~/.claude/.credentials.json, ~/.codex/auth.json) nunca são lidos, e variáveis de ambiente ou cabeçalhos de servidor MCP com nome de segredo (*_TOKEN, *_API_KEY, Authorization etc.) são removidos e listados no relatório, para você recolocá-los de propósito. Rode hermes setup para configurar provedores, ou acrescente os segredos em ~/.hermes/.env.

Detalhes de comportamento

• Prévia sempre primeiro. O comando imprime o plano completo antes de aplicar; em sessões não interativas ele para na prévia, a não ser que você passe --yes.
• Ele mescla, não substitui. Entradas de memória são comparadas com o seu MEMORY.md para não duplicar; padrões de permissão e de negação se juntam ao que já está no config.yaml.
• Conflitos são pulados por padrão. Um servidor MCP ou uma skill que já existe no Hermes é reportado como conflito; passe --overwrite para substituir.
• Arquivos malformados não abortam a execução. Um settings.json ou config.toml quebrado vira um erro daquele item no relatório, e todo o resto é importado.
• Vindo do OpenClaw? Use o hermes claw migrate.