From f0cd30065a5ea79dd6c4053635ad41baf25b530d Mon Sep 17 00:00:00 2001 From: Aaron Ogle Date: Tue, 28 Jul 2026 16:25:29 -0500 Subject: [PATCH] docs: add Grok Build to supported agent integrations Document atomic-grok in the install matrix, per-agent notes, overview, workflows, and agent command reference. Ships with Atomic 0.12.0 and atomicdotdev/atomic#135. --- docs/agents/installing-agent-integrations.md | 11 +++++++++++ docs/agents/overview.md | 3 +++ docs/commands/agent.md | 4 +++- docs/getting-started/ai-agent-workflows.md | 3 +++ 4 files changed, 20 insertions(+), 1 deletion(-) diff --git a/docs/agents/installing-agent-integrations.md b/docs/agents/installing-agent-integrations.md index d95a4c9..c776722 100644 --- a/docs/agents/installing-agent-integrations.md +++ b/docs/agents/installing-agent-integrations.md @@ -95,6 +95,7 @@ Every integration installs the same way — `atomic agent enable --agent ` | `atomic-copilot` | GitHub Copilot | `atomic agent enable --agent copilot` | https://github.com/atomicdotdev/atomic-copilot | | `atomic-cursor` | Cursor | `atomic agent enable --agent cursor` | https://github.com/atomicdotdev/atomic-cursor | | `atomic-devin` | Devin | `atomic agent enable --agent devin` | https://github.com/atomicdotdev/atomic-devin | +| `atomic-grok` | Grok Build | `atomic agent enable --agent grok` | https://github.com/atomicdotdev/atomic-grok | | `atomic-kilo` | Kilo Code | `atomic agent enable --agent kilo` | https://github.com/atomicdotdev/atomic-kilo | | `atomic-kiro` | Kiro | `atomic agent enable --agent kiro` | https://github.com/atomicdotdev/atomic-kiro | | `atomic-opencode` | OpenCode | `atomic agent enable --agent opencode` | https://github.com/atomicdotdev/atomic-opencode | @@ -164,6 +165,15 @@ atomic agent enable --agent devin Installs Devin's instruction and hook wiring so sessions record with provenance. +### Grok Build + +```bash +atomic agent enable --agent grok +grok +``` + +Installs global hooks under `~/.grok/hooks/`, home rules at `~/.grok/rules/atomic.md`, and the three core skills into `~/.grok/skills/`. Global hooks are always trusted by Grok, so no project `/hooks-trust` step is required. Grok fires SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, and SessionEnd — the full six-event lifecycle. Requires Atomic CLI **>= 0.12.0**. + ### Kilo Code ```bash @@ -259,6 +269,7 @@ atomic agent disable --all | `atomic-copilot` | `atomic agent disable --agent copilot`, then remove the repo-local files from your default branch if they were added only for Copilot | | `atomic-cursor` | `atomic agent disable --agent cursor` | | `atomic-devin` | `atomic agent disable --agent devin` | +| `atomic-grok` | `atomic agent disable --agent grok` | | `atomic-kilo` | `atomic agent disable --agent kilo` | | `atomic-kiro` | `atomic agent disable --agent kiro`, then remove hooks from the Kiro IDE panel | | `atomic-opencode` | `atomic agent disable --agent opencode` | diff --git a/docs/agents/overview.md b/docs/agents/overview.md index be634b8..c82dd17 100644 --- a/docs/agents/overview.md +++ b/docs/agents/overview.md @@ -78,6 +78,7 @@ Supported agents: | `atomic-copilot` | GitHub Copilot | | `atomic-cursor` | Cursor | | `atomic-devin` | Devin | +| `atomic-grok` | Grok Build | | `atomic-kilo` | Kilo Code | | `atomic-kiro` | Kiro | | `atomic-opencode` | OpenCode | @@ -137,6 +138,7 @@ The `+tag` is a short hash of the session ID — every agent turn traces back to |-------|---------------| | Claude Code | `claude+60f5 ` | | Gemini CLI | `gemini+abcd ` | +| Grok Build | `grok+019f ` | | OpenCode | `opencode+9876 ` | ## Agent Isolation with Views @@ -176,6 +178,7 @@ atomic view delete agent-ses_3781fc... | **atomic-copilot** | GitHub Copilot | Repository hook manifest | Session end | | **atomic-cursor** | Cursor | Cursor hooks | Turn end | | **atomic-devin** | Devin | Hook wiring | Session | +| **atomic-grok** | Grok Build | Native Grok hooks (`~/.grok/hooks/`) | Turn end | | **atomic-kilo** | Kilo Code | Rules + agent config | Turn end | | **atomic-kiro** | Kiro | IDE steering + hook scripts | Turn end | | **atomic-opencode** | OpenCode | OpenCode plugin | Session idle / turn end | diff --git a/docs/commands/agent.md b/docs/commands/agent.md index c6e3b40..20691f6 100644 --- a/docs/commands/agent.md +++ b/docs/commands/agent.md @@ -15,7 +15,7 @@ atomic agent ## Description -The `agent` command is the Atomic-side control plane for AI coding integrations. `atomic agent enable --agent ` fetches an agent-specific package — `atomic-agy`, `atomic-claude`, `atomic-cline`, `atomic-codex`, `atomic-copilot`, `atomic-cursor`, `atomic-devin`, `atomic-kilo`, `atomic-kiro`, `atomic-opencode`, or `atomic-pi` — from Atomic storage and installs its hooks, plugins, extensions, skills, and instruction files for the host agent. Those hooks call back into `atomic agent hooks ` so Atomic can record turns and sessions with provenance. +The `agent` command is the Atomic-side control plane for AI coding integrations. `atomic agent enable --agent ` fetches an agent-specific package — `atomic-agy`, `atomic-claude`, `atomic-cline`, `atomic-codex`, `atomic-copilot`, `atomic-cursor`, `atomic-devin`, `atomic-grok`, `atomic-kilo`, `atomic-kiro`, `atomic-opencode`, or `atomic-pi` — from Atomic storage and installs its hooks, plugins, extensions, skills, and instruction files for the host agent. Those hooks call back into `atomic agent hooks ` so Atomic can record turns and sessions with provenance. When an integration is active, every supported turn or task is automatically recorded as an Atomic change with full provenance, and every session produces a provenance graph (causal decision DAG) and an attestation (session-level audit node). @@ -262,6 +262,7 @@ Agent author: claude+60f5 |-------|---------------| | Claude Code | `claude+60f5 ` | | Gemini CLI | `gemini+abcd ` | +| Grok Build | `grok+019f ` | | OpenCode | `opencode+9876 ` | ## Supported Integration Packages @@ -275,6 +276,7 @@ Agent author: claude+60f5 | `atomic-copilot` | GitHub Copilot | [Installing Agent Integrations](/agents/installing-agent-integrations#github-copilot) | | `atomic-cursor` | Cursor | [Installing Agent Integrations](/agents/installing-agent-integrations#cursor) | | `atomic-devin` | Devin | [Installing Agent Integrations](/agents/installing-agent-integrations#devin) | +| `atomic-grok` | Grok Build | [Installing Agent Integrations](/agents/installing-agent-integrations#grok-build) | | `atomic-kilo` | Kilo Code | [Installing Agent Integrations](/agents/installing-agent-integrations#kilo-code) | | `atomic-kiro` | Kiro | [Installing Agent Integrations](/agents/installing-agent-integrations#kiro) | | `atomic-opencode` | OpenCode | [Installing Agent Integrations](/agents/installing-agent-integrations#opencode) | diff --git a/docs/getting-started/ai-agent-workflows.md b/docs/getting-started/ai-agent-workflows.md index 3958116..27b880a 100644 --- a/docs/getting-started/ai-agent-workflows.md +++ b/docs/getting-started/ai-agent-workflows.md @@ -34,6 +34,7 @@ atomic agent enable | `atomic-copilot` | GitHub Copilot | | `atomic-cursor` | Cursor | | `atomic-devin` | Devin | +| `atomic-grok` | Grok Build | | `atomic-kilo` | Kilo Code | | `atomic-kiro` | Kiro | | `atomic-opencode` | OpenCode | @@ -223,6 +224,7 @@ The `+tag` is a short hash of the session ID — every agent turn traces back to |-------|---------------| | Claude Code | `claude+60f5 ` | | Gemini CLI | `gemini+abcd ` | +| Grok Build | `grok+019f ` | | OpenCode | `opencode+9876 ` | ## Supported Agent Integrations @@ -236,6 +238,7 @@ The `+tag` is a short hash of the session ID — every agent turn traces back to | **atomic-copilot** | GitHub Copilot | Repository hook manifest | Manifest must be on the default branch for the cloud agent | | **atomic-cursor** | Cursor | Hooks + rules | Follows the Atomic intent workflow in-project | | **atomic-devin** | Devin | Hook wiring | — | +| **atomic-grok** | Grok Build | Global hooks + rules + skills | Installs to `~/.grok/`; requires CLI >= 0.12.0 | | **atomic-kilo** | Kilo Code | Rules + agent config | Reads `.kilo/` config | | **atomic-kiro** | Kiro | IDE steering + hooks | Configure hooks in the Kiro IDE panel | | **atomic-opencode** | OpenCode | Plugin + agent + skills | Select the Atomic agent in OpenCode |