Skip to content

Grok CLI support details

Rules, skills, MCP, and hooks are native; prompts become skills.

Grok CLI is xAI's coding agent CLI with native TOML MCP config, modular rules, and hooks.

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 Grok CLI.

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

Editor-specific notes

  • Grok CLI prompts are converted into skills because custom commands in the TUI are backed by skills.
  • Grok CLI supports both project-scoped (.grok/config.toml) and user-scoped (~/.grok/config.toml) MCP configuration.

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

Markdown rule files in .grok/rules/.

Grok CLI calls this Rules
aix support Native
Project
Editor Supported aix Native
Path .grok/rules/*.md
User
Editor Supported aix Native
Path ~/.grok/rules/*.md
  • Grok CLI also discovers AGENTS.md in project roots as a compatibility surface.

Prompts Learn the concept

Prompt-to-skill conversion during install.

Grok CLI calls this Skills
aix support Adapter
Project
Editor Supported aix Adapter
Path .grok/skills/prompt-{name}/
aix: Prompts are installed as instruction-only Agent Skills.
User
Editor Supported aix Adapter
Path ~/.grok/skills/prompt-{name}/
aix: User-scoped prompts are also converted to skills.

MCP Learn the concept

TOML MCP server configuration in .grok/config.toml.

Grok CLI calls this MCP servers
aix support Native
Project
Editor Supported aix Native
Path .grok/config.toml
User
Editor Supported aix Native
Path ~/.grok/config.toml

Skills Learn the concept

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

Grok CLI calls this Skills
aix support Native
Project
Editor Supported aix Native
Path .grok/skills/{name}/
User
Editor Supported aix Native
Path ~/.grok/skills/{name}/

Agents

Grok CLI does not document custom subagent files that aix can write safely.

Grok CLI calls this Agents
aix support No support
Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix reports configured agents as unsupported for Grok CLI.
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix reports configured agents as unsupported for Grok CLI.

Hooks Learn the concept

JSON hooks in .grok/hooks.json.

Grok CLI calls this Hooks
aix support Native
Project
Editor Supported aix Native
Path .grok/hooks.json
User
Editor Supported aix Native
Path ~/.grok/hooks.json

Supported metadata: Notification , PermissionDenied , PostCompact , PostToolUse , PostToolUseFailure , PreCompact , PreToolUse , SessionEnd , SessionStart , Stop , UserPromptSubmit

Plugins

Compatibility unpacking into native rules and MCP servers.

Grok CLI calls this Plugins
aix support Adapter
Project
Editor Supported aix Adapter
Path .grok/
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Grok does not support native plugin bundles.

Marketplaces

Grok does not support custom AI agent marketplaces.

Grok CLI calls this Marketplaces
aix support No support
Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Grok does not support custom AI marketplaces.
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Grok does not support custom AI marketplaces.

AGENTS.md

Grok CLI natively reads AGENTS.md in repository roots.

Grok CLI calls this AGENTS.md
aix support Native
Project
Editor Supported aix Native
Path AGENTS.md
User
Editor Supported aix Native
Path ~/.grok/AGENTS.md

.agents/skills

Compatibility with the shared Agent Skills folder convention.

Grok CLI 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