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/.
- Project
- Editor Supported aix NativePath
.grok/rules/*.md - User
- Editor Supported aix NativePath
~/.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.
- Project
- Editor Supported aix AdapterPath
.grok/skills/prompt-{name}/aix: Prompts are installed as instruction-only Agent Skills. - User
- Editor Supported aix AdapterPath
~/.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.
- Project
- Editor Supported aix NativePath
.grok/config.toml - User
- Editor Supported aix NativePath
~/.grok/config.toml
Skills Learn the concept
Symlinked native skill directories backed by .aix/skills/.
- Project
- Editor Supported aix NativePath
.grok/skills/{name}/ - User
- Editor Supported aix NativePath
~/.grok/skills/{name}/
Agents
Grok CLI does not document custom subagent files that aix can write safely.
- Project
- Editor No support aix No supportEditor: 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 supportEditor: 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.
- Project
- Editor Supported aix NativePath
.grok/hooks.json - User
- Editor Supported aix NativePath
~/.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.
- Project
- Editor Supported aix AdapterPath
.grok/ - User
- Editor No support aix No supportEditor: 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.
- Project
- Editor No support aix No supportEditor: The editor does not expose this feature at this scope. aix: Grok does not support custom AI marketplaces.
- User
- Editor No support aix No supportEditor: 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.
- Project
- Editor Supported aix NativePath
AGENTS.md - User
- Editor Supported aix NativePath
~/.grok/AGENTS.md
.agents/skills
Compatibility with the shared Agent Skills folder convention.
- Project
- Editor Supported aix NativePath
.agents/skills/{name}/ - User
- Editor Supported aix NativePath
~/.agents/skills/{name}/