Skip to main content

Adapters

Adapters define how Agloom transpiles canonical configurations into agent-specific files. Each adapter targets a specific AI coding assistant.

Adapter Table

IDDescriptionOutput FilesHidden
claudeClaude CodeCLAUDE.md, .mcp.jsonNo
opencodeOpenCodeopencode.jsonNo
agentsmdAGENTS.md (Codex, OpenCode, KiloCode, ...)AGENTS.md, AGENTS.override.mdYes
kilocodeKiloCode(none)No
codexCodex (OpenAI)(none)No
geminiGemini (Google)GEMINI.mdNo

Per-Adapter Details

claude

  • Instructions file: CLAUDE.md
  • Dependencies: None
  • Output paths:
TypePath
Skills.claude/skills
Agents.claude/agents
Commands.claude/commands
Docs.claude/docs
Schemas.claude/schemas
  • Target files: CLAUDE.md, .mcp.json
  • Overlay import paths: .claude, **/CLAUDE.md, .mcp.json

opencode

  • Instructions file: None (uses AGENTS.md via agentsmd dependency)
  • Dependencies: agentsmd
  • Output paths:
TypePath
Skills.opencode/skills
Agents.opencode/agents
Commands.opencode/commands
Docs.opencode/docs
Schemas.opencode/schemas
  • Target files: opencode.json
  • Overlay import paths: .opencode, opencode.json

OpenCode does not have its own instruction file format. The AGENTS.md file is generated by the agentsmd adapter, which is automatically included as a dependency.

agentsmd

  • Instructions file: AGENTS.md
  • Dependencies: None
  • Output paths: (none -- empty paths object)
  • Target files: AGENTS.md, AGENTS.override.md
  • Overlay import paths: .agents, **/AGENTS.md, **/AGENTS.override.md
  • Hidden: Yes -- cannot be specified in config or via --adapter. Included only as a dependency of other adapters or when using --all.

The agentsmd adapter produces the AGENTS.md format used by multiple AI coding assistants (OpenCode, KiloCode, Codex, and others).

kilocode

  • Instructions file: None (uses AGENTS.md via agentsmd dependency)
  • Dependencies: agentsmd
  • Output paths:
TypePath
Skills.kilo/skills
Agents.kilo/agents
Commands.kilo/commands
Docs.kilo/docs
Schemas.kilo/schemas
  • Target files: (none)
  • Overlay import paths: .kilo

codex

  • Instructions file: None (uses AGENTS.md via agentsmd dependency)
  • Dependencies: agentsmd
  • Output paths:
TypePath
Skills.agents/skills
Agents.codex/agents

Note: Codex places skills in .agents/skills/ (not .codex/skills/).

  • Target files: (none)
  • Overlay import paths: .codex, .agents

gemini

  • Instructions file: GEMINI.md
  • Dependencies: None
  • Output paths:
TypePath
Skills.gemini/skills
Agents.gemini/agents
Commands.gemini/commands
Docs.gemini/docs
Schemas.gemini/schemas
  • Target files: GEMINI.md
  • Overlay import paths: .gemini, **/GEMINI.md

Capability Matrix

Featureclaudeopencodeagentsmdkilocodecodexgemini
InstructionsYesNo-opYesNo-opNo-opYes
CommandsYesYesNoYesYes (as skills)Yes (TOML)
SkillsYesYesNoYesYesYes
AgentsYesYesNoYesYesYes
DocsYesYesNoYesYesYes
SchemasYesYesNoYesYesYes
MCPYesYesNoNoNoNo
PermissionsYesYesNoNoNoNo
OverlaysYesYesYesYesYesYes

Adapters marked "No-op" for Instructions return an empty array -- their instruction files are generated by a dependency adapter (typically agentsmd).

Adapters marked "No" for Skills/Agents have an empty paths object and do not produce skill or agent directories.

For Commands: Codex converts commands into skill packages at .agents/skills/. Gemini converts commands from Markdown to TOML format. See Transpilers for full details on the commands transpiler.

Dependencies

Dependencies are resolved automatically. When you specify an adapter (via config or --adapter), its dependencies are included before it in topological order.

AdapterDepends On
claude(none)
opencodeagentsmd
agentsmd(none)
kilocodeagentsmd
codexagentsmd
gemini(none)

Example: Specifying opencode in config results in the transpilation order: agentsmd then opencode.

Hidden Adapters

Hidden adapters have hidden: true and:

  • Cannot be specified in .agloom/config.yml.
  • Cannot be used with --adapter.
  • Do not appear in agloom adapters output.
  • Are included only via dependsOn of another adapter, or when using --all.

Currently, agentsmd is the only hidden adapter.