Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions docs/agents/installing-agent-integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,7 @@ Every integration installs the same way — `atomic agent enable --agent <name>`
| `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 |
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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` |
Expand Down
3 changes: 3 additions & 0 deletions docs/agents/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down Expand Up @@ -137,6 +138,7 @@ The `+tag` is a short hash of the session ID — every agent turn traces back to
|-------|---------------|
| Claude Code | `claude+60f5 <lee@atomic.dev>` |
| Gemini CLI | `gemini+abcd <lee@atomic.dev>` |
| Grok Build | `grok+019f <lee@atomic.dev>` |
| OpenCode | `opencode+9876 <lee@atomic.dev>` |

## Agent Isolation with Views
Expand Down Expand Up @@ -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 |
Expand Down
4 changes: 3 additions & 1 deletion docs/commands/agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ atomic agent <SUBCOMMAND>

## Description

The `agent` command is the Atomic-side control plane for AI coding integrations. `atomic agent enable --agent <name>` 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 <agent> <verb>` 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 <name>` 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 <agent> <verb>` 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).

Expand Down Expand Up @@ -262,6 +262,7 @@ Agent author: claude+60f5 <lee@atomic.dev>
|-------|---------------|
| Claude Code | `claude+60f5 <lee@atomic.dev>` |
| Gemini CLI | `gemini+abcd <lee@atomic.dev>` |
| Grok Build | `grok+019f <lee@atomic.dev>` |
| OpenCode | `opencode+9876 <lee@atomic.dev>` |

## Supported Integration Packages
Expand All @@ -275,6 +276,7 @@ Agent author: claude+60f5 <lee@atomic.dev>
| `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) |
Expand Down
3 changes: 3 additions & 0 deletions docs/getting-started/ai-agent-workflows.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down Expand Up @@ -223,6 +224,7 @@ The `+tag` is a short hash of the session ID — every agent turn traces back to
|-------|---------------|
| Claude Code | `claude+60f5 <lee@atomic.dev>` |
| Gemini CLI | `gemini+abcd <lee@atomic.dev>` |
| Grok Build | `grok+019f <lee@atomic.dev>` |
| OpenCode | `opencode+9876 <lee@atomic.dev>` |

## Supported Agent Integrations
Expand All @@ -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 |
Expand Down