How-To Series · 1: Get Running

Import from Other Agents

Bring your OpenClaw, Claude Code, OpenAI Codex CLI or Cursor setup into Hermes with one command: instructions, rules, allowlists, MCP servers and skills, previewed before anything is written.

After this videoYou can move your Claude Code, Codex, Cursor or OpenClaw setup into Hermes, preview it first, and keep it in sync as the other agent changes.

hermes import-agent comes from the official agent-importers plugin, maintained by Nous Research. Install it once per profile with hermes plugins install agent-importers, or let hermes setup do it: on a fresh install, setup looks for ~/.openclaw, ~/.claude, ~/.codex and ~/.cursor first and offers the import. You always see a per-item plan before anything is written, and --dry-run never touches disk. Global instructions (CLAUDE.md, AGENTS.md, Cursor rules) become MEMORY.md entries, Claude Bash allow and deny rules become command_allowlist and approvals.deny, MCP servers go to mcp_servers in config.yaml, and skills land in a <source>-imports folder. Credentials are never imported, except OpenClaw keys and bot tokens with --migrate-secrets. Imports merge without duplicates, skip conflicts unless you pass --overwrite, and hermes import-agent --sync re-imports only the sources that changed.

About these resources. Every command in this video comes from the Import from Other Agents doc.

New words here · Plain English

one sentence each · full glossary

hermes import-agentOne command that copies your setup from OpenClaw, Claude Code, Codex CLI or Cursor into Hermes. It shows you the plan before it writes anything.

agent-importersThe official plugin from Nous Research that provides import-agent. Install it once per profile, or let hermes setup install it for you.

Dry runA preview mode. With --dry-run the command shows what it would import and changes nothing on disk.

Import syncRunning import-agent with --sync re-imports only the sources that changed since last time, so it is safe to schedule.

Sources · What this video distills

1 docs page · every command below traces to it

Primary guide

Import from Other Agents

Commands shown · Copy and paste

each shows the source doc it came from

Install the plugin once per profilefrom source ↗

hermes plugins install agent-importers

Auto-detect and importfrom source ↗

hermes import-agent

Preview a Claude Code import (never touches disk)from source ↗

hermes import-agent claude-code --dry-run

Import from a custom locationfrom source ↗

hermes import-agent codex --source /path/to/.codex

Replace conflicts and skip promptsfrom source ↗

hermes import-agent claude-code --overwrite --yes

Pull in later changes (add --dry-run to preview)from source ↗

hermes import-agent --sync

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

Migrate from OpenClaw

The full OpenClaw mapping and its flags.

Where agent-importers comes from.

Keep a clone's imported setups synced.

Next in the series · Episodes that build on this

One-Line Install

Connect Anything With MCP