Documentation
Platforms and capabilities
Every adapter declares what it supports instead of claiming to be compatible. This page is generated from those declarations.
Support levels
- Full
- Direct import and export for the declared capabilities.
- Partial
- Direct integration exists, but some capabilities require conversion or are unsupported.
- Experimental
- Integration exists but has limited testing or incomplete compatibility.
- Guided
- Nomad prepares the files and guides you through the remaining manual steps.
- Unavailable
- No reliable integration is currently possible.
Write capabilities
What Nomad can put into each platform. Read support is listed per platform below.
| Platform | Identity | Instructions | Memory | Skills | Tools | Integrations | Models | Permissions | Workflows | Knowledge files |
|---|---|---|---|---|---|---|---|---|---|---|
| OpenClaw partial | Full | Full | Full | Full | Manual | Manual | Converts | Converts | Full | Manual |
| Claude Code partial | Converts | Full | Converts | Full | Full | Manual | Converts | Converts | No | Manual |
| Codex CLI partial | Converts | Full | Converts | Full | Full | Manual | Converts | Converts | No | Manual |
| Hermes Agent partial | Converts | Converts | Converts | Full | Converts | Manual | Converts | Converts | Full | Manual |
| Agent folder full | Full | Full | Full | Full | Full | Full | Full | Full | Full | Full |
| Cursor partial | Converts | Full | Converts | Manual | Converts | Manual | Manual | Manual | No | Manual |
| Windsurf partial | Converts | Full | Converts | Manual | Manual | Manual | Manual | Manual | No | Manual |
| Cline partial | Converts | Full | Converts | Manual | Manual | Manual | Manual | Manual | No | Manual |
| Roo Code partial | Converts | Full | Converts | Manual | Converts | Manual | Manual | Manual | No | Manual |
| Continue partial | Converts | Full | Converts | Manual | Manual | Manual | Manual | Manual | No | Manual |
| OpenCode partial | Converts | Full | Converts | Manual | Converts | Manual | Manual | Manual | No | Manual |
| Goose partial | Converts | Full | Converts | Manual | Converts | Manual | Manual | Manual | No | Manual |
| Aider partial | Converts | Full | Converts | Manual | Manual | Manual | Manual | Manual | No | Manual |
| Gemini CLI partial | Converts | Full | Converts | Manual | Converts | Manual | Manual | Manual | No | Manual |
| ChatGPT guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Claude (claude.ai) guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Gemini guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Grok guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Perplexity guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| CrewAI guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| LangGraph guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| LangChain guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| AutoGen guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Semantic Kernel guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| PydanticAI guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Agno guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Mastra guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Dify guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Flowise guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| n8n guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
| Letta guided | Manual | Manual | Manual | Manual | Manual | Manual | Manual | No | Manual | Manual |
Details
OpenClaw partial
Reads and writes OpenClaw agents, workspaces, memory, skills, cron jobs and per agent model and tool settings.
Built for: OpenClaw workspace layout (AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md, memory/, skills/) and cron/jobs.json. Default location ~/.openclaw. Id openclaw.
- Tools: OpenClaw reaches MCP servers through plugins. Nomad lists them for manual setup.
- Integrations: Channels and credentials must be reconnected.
- Models: Written as provider/model.
- Permissions: Deny rules become tools.deny entries. Allow rules are documented, not applied.
- openclaw.json is rewritten as JSON, so comments in it are not preserved. A backup is always taken.
- Session transcripts are not migrated.
Claude Code partial
Reads and writes user (~/.claude) and project (.claude/) configuration, subagents, skills, slash commands, permissions and MCP servers.
Built for: Claude Code 2.x configuration layout (CLAUDE.md, settings.json, agents/, skills/, commands/, MCP files). Default location ~/.claude. Id claude-code.
- Identity: Main agents have no name field. Nomad keeps the name in a managed block; subagents store it natively.
- Memory: Memory is written to Markdown files imported from CLAUDE.md with @imports.
- Tools: MCP servers. Secret values become ${VAR} references you set in your environment.
- Integrations: Connectors outside MCP need to be reconnected.
- Models: Only Anthropic models are applied. Other models are recorded in the report.
- Permissions: allow, ask and deny rules map to tool rules. Browser, computer and schedule rules have no equivalent.
- Workflows: Claude Code has no local scheduler. Routines are kept in the package with setup steps.
- Knowledge files: Knowledge files are referenced, not copied into the configuration.
- User level MCP servers live in ~/.claude.json, which Claude Code also rewrites. Close Claude Code before migrating.
- Scheduled routines cannot be imported.
Codex CLI partial
Reads and writes AGENTS.md, config.toml (model, approval policy, sandbox, MCP servers), skills and custom prompts.
Built for: Codex CLI configuration layout (AGENTS.md, config.toml, skills/, prompts/). Default location ~/.codex. Id codex.
- Identity: Codex has no agent name or persona file. Persona is written into AGENTS.md.
- Memory: Codex has no memory store. Memory is written as a section of AGENTS.md.
- Tools: MCP servers in config.toml. Secrets are not written; set them in your environment.
- Models: Only OpenAI models are applied.
- Permissions: Mapped onto approval_policy, sandbox_mode and network access. Pattern rules cannot be enforced.
- Workflows: Codex has no scheduler.
- One agent per Codex home. Copy mode is not available.
- TOML comments in config.toml are not preserved on merge.
Hermes Agent partial
Reads and writes Hermes profiles: persona, MEMORY.md and USER.md entries, skills, MCP servers, cron jobs and command allowlists.
Built for: Hermes Agent home layout (~/.hermes: SOUL.md, memories/, skills/, cron/jobs.json, config.yaml, profiles/). Default location ~/.hermes. Id hermes.
- Identity: Persona lives in SOUL.md. The name is kept in a Nomad section.
- Instructions: Hermes has no separate instruction file. Instructions are added to SOUL.md in a Nomad section.
- Memory: Entries are written to MEMORY.md and USER.md with the § delimiter. Hermes enforces character limits.
- Tools: MCP servers in config.yaml. Secrets belong in ~/.hermes/.env.
- Integrations: Messaging platforms and OAuth must be reconnected.
- Permissions: Shell allow patterns map to command_allowlist. Other rules are documented.
- Hermes memory has character limits (2,200 for MEMORY.md and 1,375 for USER.md by default). Larger imports are reported.
Agent folder full
An unpacked Nomad package, or any folder of Markdown agent files (AGENTS.md, SOUL.md, MEMORY.md, skills/). Lossless for packages.
Built for: Universal Agent Format 1.0, plus Markdown agent folders. Point Nomad at the project folder. Id generic.
- Plain Markdown folders are read heuristically. Unpacked Nomad packages are read exactly.
Cursor partial
Project rules in .cursor/rules (MDC), legacy .cursorrules and AGENTS.md, plus .cursor/mcp.json.
Built for: Documented rules and configuration files as of late 2026. Point Nomad at the project folder. Id cursor.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written as a section of the rules file.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers are written to the platform MCP file.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
Windsurf partial
Workspace rules in .windsurf/rules and the legacy .windsurfrules file.
Built for: Documented rules and configuration files as of late 2026. Point Nomad at the project folder. Id windsurf.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written as a section of the rules file.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers need manual setup.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
Cline partial
Workspace rules in .clinerules (file or folder).
Built for: Documented rules and configuration files as of late 2026. Point Nomad at the project folder. Id cline.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written as a section of the rules file.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers need manual setup.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
Roo Code partial
Rules in .roo/rules and project MCP servers in .roo/mcp.json.
Built for: Documented rules and configuration files as of late 2026. Point Nomad at the project folder. Id roo-code.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written as a section of the rules file.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers are written to the platform MCP file.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
Continue partial
Rules in .continue/rules (Markdown with frontmatter).
Built for: Documented rules and configuration files as of late 2026. Default location ~/.continue. Id continue.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written as a section of the rules file.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers need manual setup.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
OpenCode partial
AGENTS.md, agent definitions in agent/, and MCP servers in opencode.json.
Built for: Documented rules and configuration files as of late 2026. Default location ~/.config/opencode. Id opencode.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written as a section of the rules file.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers are written to the platform MCP file.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
Goose partial
.goosehints instructions and extensions in config.yaml.
Built for: Documented rules and configuration files as of late 2026. Default location ~/.config/goose. Id goose.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written as a section of the rules file.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers are written to the platform MCP file.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
Aider partial
CONVENTIONS.md loaded through the read list in .aider.conf.yml.
Built for: Documented rules and configuration files as of late 2026. Point Nomad at the project folder. Id aider.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written as a section of the rules file.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers need manual setup.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
Gemini CLI partial
GEMINI.md context files and MCP servers in settings.json.
Built for: Documented rules and configuration files as of late 2026. Default location ~/.gemini. Id gemini-cli.
- Identity: Name and persona are written into the rules file.
- Memory: Memory is written into GEMINI.md, which is where Gemini CLI saves its own memories.
- Skills: No skill system. Skill instructions are listed for manual setup.
- Tools: MCP servers are written to the platform MCP file.
- Models: Model selection is left to the platform settings.
- Permissions: Permissions are documented in the rules file, not enforced.
- Scheduled routines, model choice and permission enforcement stay in the application settings.
Guided platforms
Hosted products (ChatGPT, Claude, Gemini, Grok, Perplexity) do not offer an agent import, and frameworks (CrewAI, LangGraph, LangChain, AutoGen, Semantic Kernel, PydanticAI, Agno, Mastra, Dify, Flowise, n8n, Letta) define agents in code or in their own apps. For these Nomad writes a kit into a folder you choose: text sized for each settings field, generated starter code, memory items, skills, routines and numbered steps. Nothing is sent to those services.