/agent-brain-install-agent

name: agent-brain-install-agent
description: Install Agent Brain plugin for a specific runtime (Claude, OpenCode, Codex, Cursor, Grok, skill-runtime)
parameters:
  - name: agent
    description: "Target runtime: claude, opencode, codex, cursor, grok, or skill-runtime"
    required: true
  - name: scope
    description: "Install scope: project (default) or global"
    required: false
    default: project
  - name: plugin-dir
    description: Custom canonical plugin source directory
    required: false
  - name: dir
    description: Target skill directory (required for skill-runtime)
    required: false
  - name: dry-run
    description: List files that would be created without writing
    required: false
  - name: json
    description: Output as JSON
    required: false
  - name: path
    description: "Project path for --project scope (default: cwd)"
    required: false
  - name: with-mcp
    description: Also register the agent-brain MCP server in the runtime's MCP config (Claude, OpenCode, Codex, Cursor, Grok)
    required: false
  - name: mcp-auth
    description: "MCP client auth mode to record: none (default) or oauth"
    required: false
    default: none
  - name: mcp-backend
    description: "How the MCP server reaches agent-brain-serve: auto (default), uds, or http"
    required: false
    default: auto
skills:
  - configuring-agent-brain
last_validated: 2026-09-19

Agent Brain Install Agent

Purpose

Installs Agent Brain plugin files for a specific AI coding runtime. Converts the canonical plugin format into the target runtime's native format and writes the files to the appropriate directory.

Supported runtimes:

• **Claude Code** — copies plugin as-is with path normalization
• **OpenCode** — converts tool lists to boolean objects, maps tool names to lowercase
• **Codex** — creates skill directories under `.codex/skills/agent-brain/` and generates AGENTS.md
• **Cursor** — Claude layout plus `.cursor-plugin/plugin.json`, `.cursor/rules/`, and the universal `plugin.json` + `mcp.json`
• **Grok Build** — Claude layout plus `.grok-plugin/marketplace.json` (Grok loads Claude plugins with zero config)
• **skill-runtime** — generic converter producing skill directories with SKILL.md frontmatter (requires `--dir`)

Usage

agent-brain install-agent --agent <runtime> [--project|--global] [--plugin-dir <path>] [--dir <path>] [--dry-run] [--json] [--path <path>]

Parameters

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | --agent / -a | Yes | - | Target runtime: `claude`, `opencode`, `codex`, `cursor`, `grok`, or `skill-runtime` | | --project | No | Yes | Install to project directory (default) | | --global | No | No | Install to user-level directory | | --plugin-dir | No | Auto-detect | Custom canonical plugin source directory | | --dir | No* | - | Target skill directory (*required for skill-runtime) | | --dry-run | No | No | List files without writing | | --json | No | No | Machine-readable JSON output | | --path / -p | No | cwd | Project path for --project scope |

Install Directories

| Runtime | Project Scope | Global Scope | |---------|---------------|--------------| | Claude | `.claude/plugins/agent-brain/` | `~/.claude/plugins/agent-brain/` | | OpenCode | `.opencode/plugins/agent-brain/` | `~/.config/opencode/plugins/agent-brain/` | | Codex | `.codex/skills/agent-brain/` | `~/.codex/skills/agent-brain/` | | Cursor | `.cursor/plugins/agent-brain/` | `~/.cursor/plugins/agent-brain/` | | Grok Build | `.grok/plugins/agent-brain/` | `~/.grok/plugins/agent-brain/` | | skill-runtime | Requires `--dir` | Requires `--dir` |

Execution

Install for Claude Code (default)

agent-brain install-agent --agent claude --project

Install for OpenCode

agent-brain install-agent --agent opencode --project

Install for Codex

agent-brain install-agent --agent codex --project

This creates skill directories under `.codex/skills/agent-brain/` and generates an `AGENTS.md` file at the project root.

Install for Cursor

agent-brain install-agent --agent cursor --project --with-mcp

Writes `.cursor/plugins/agent-brain/` with the Claude layout, `.cursor-plugin/plugin.json`, `.cursor/rules/agent-brain.mdc`, and the universal `plugin.json` + `mcp.json`. `--with-mcp` registers the server in `.cursor/mcp.json`.

Install for Grok Build

agent-brain install-agent --agent grok --project --with-mcp

Grok Build loads Claude plugins with zero config. The install adds `.grok-plugin/marketplace.json` for marketplace identity. `--with-mcp` writes the same `.mcp.json` as Claude Code.

Install for Generic Skill-Runtime

agent-brain install-agent --agent skill-runtime --dir ./my-skills

The `--dir` flag is required for skill-runtime (it has no default directory).

Global Installation

agent-brain install-agent --agent claude --global

Preview Without Installing

agent-brain install-agent --agent claude --dry-run

JSON Output

agent-brain install-agent --agent claude --json

Custom Plugin Source

agent-brain install-agent --agent opencode --plugin-dir ./my-custom-plugin

Register the MCP server (all hosts with an MCP config file)

Add `--with-mcp` to also register the `agent-brain` MCP server while installing. It writes/merges an `agent-brain` entry into the runtime's MCP config, preserving any other servers and keys, and pins an absolute `AGENT_BRAIN_STATE_DIR`. It is idempotent and honors `--dry-run`.

# Install plugin + register MCP for Claude Code (→ .mcp.json / ~/.claude.json)
agent-brain install-agent --agent claude --with-mcp

# ...for OpenCode (→ project-root opencode.json)
agent-brain install-agent --agent opencode --with-mcp

# ...for Codex (→ ~/.codex/config.toml, TOML [mcp_servers.agent-brain])
agent-brain install-agent --agent codex --with-mcp

# ...for Cursor (