Skip to content

Gemini support details

Native GEMINI.md rules, TOML command prompts, MCP, skills, and hooks.

Gemini is a strong target for native prompts, MCP, and the new hooks system.

Start on the full support matrix when you need to compare every editor at once. Use this page when you want the exact terms, support details, and project/user targets for Gemini.

Related aix concepts: rules , prompts , mcp , skills , hooks .

Editor-specific notes

  • Gemini prompts are TOML files, not markdown command files.
  • Like Codex, Gemini collapses rule activation metadata into managed markdown content.
  • Gemini hooks share .gemini/settings.json with MCP; aix merges both blocks safely.

Feature details

How to read the statuses

Support key

Editor support

  • Supported The editor exposes that feature at that scope.
  • No support The editor does not expose that feature at that scope.

aix support

  • Native aix writes the editor's own format.
  • Adapter aix keeps the feature through an adapter or alternate representation.
  • No support aix does not write that feature for the destination today.

Use the Project scope and User scope rows to see where config lands at each level.

Rules Learn the concept

Section-managed markdown in GEMINI.md.

Gemini calls this GEMINI.md
aix support Native
Project
Editor Supported aix Native
Path GEMINI.md
User
Editor Supported aix Native
Path ~/.gemini/GEMINI.md
  • Activation modes are flattened into the managed markdown section.

Prompts Learn the concept

TOML command files with description and prompt fields.

Gemini calls this Commands
aix support Native
Project
Editor Supported aix Native
Path .gemini/commands/*.toml
User
Editor Supported aix Native
Path ~/.gemini/commands/*.toml

MCP Learn the concept

JSON settings file with editor-native MCP config.

Gemini calls this MCP servers
aix support Native
Project
Editor Supported aix Native
Path .gemini/settings.json
User
Editor Supported aix Native
Path ~/.gemini/settings.json

Skills Learn the concept

Symlinked native skill directories backed by .aix/skills/.

Gemini calls this Skills
aix support Native
Project
Editor Supported aix Native
Path .gemini/skills/{name}/
User
Editor Supported aix Native
Path ~/.gemini/skills/{name}/
  • Gemini also supports .agents/skills/ as an alias and gives it precedence.

Agents

Markdown subagent files with YAML frontmatter.

Gemini calls this Subagents
aix support Native
Project
Editor Supported aix Native
Path .gemini/agents/*.md
User
Editor Supported aix Native
Path ~/.gemini/agents/*.md

Supported metadata: description , mode , model , tools , temperature , maxTurns , editor.gemini

Hooks Learn the concept

JSON hooks under hooks in settings.json with PascalCase event names.

Gemini calls this Hooks
aix support Native
Project
Editor Supported aix Native
Path .gemini/settings.json
User
Editor Supported aix Native
Path ~/.gemini/settings.json

Supported metadata: AfterAgent , AfterModel , AfterTool , BeforeAgent , BeforeModel , BeforeTool , BeforeToolSelection , Notification , PreCompress , SessionEnd , SessionStart

  • timeout is in milliseconds (Gemini default 60000); aix multiplies seconds-based input by 1000.
  • Hook groups also accept sequential: true to run actions one at a time instead of in parallel.

AGENTS.md

Compatibility with AGENTS.md through configurable context filename support.

Gemini calls this AGENTS.md
aix support Native
Project
Editor Supported aix Native
Path AGENTS.md when `context.fileName` is configured
User
Editor Supported aix Native
Path Home-scoped AGENTS.md when `context.fileName` is configured

.agents/skills

Compatibility with the shared Agent Skills folder convention.

Gemini calls this .agents/skills
aix support Native
Project
Editor Supported aix Native
Path .agents/skills/{name}/
User
Editor Supported aix Native
Path ~/.agents/skills/{name}/

Related guides