Install the Companion

Claude Code

Claude Code (recommended)

Run the Companion as a Claude Code plugin you invoke with slash commands.

Prerequisites

• Claude Code installed. claude --version works in your terminal.
• git installed.

Install

# 1. Clone the Companion repo somewhere you keep tools
mkdir -p ~/Tools && cd ~/Tools
git clone https://github.com/grcengineering/companion.git

# 2. Create the Claude Code plugins directory and symlink the adapter
mkdir -p ~/.claude/plugins
ln -s ~/Tools/companion/dist/adapters/claude-code/companion ~/.claude/plugins/companion

# 3. Restart Claude Code so it picks up the new plugin

Verify

In any Claude Code session, type /companion:retro.

Companion should respond by asking what real work you want to learn from. If the slash command is not recognised, run ls ~/.claude/plugins/companion/ and confirm you see brain, skills, knowledge, profile, commands.

Available slash commands

• /companion:retro - retrospective on real work
• /companion:concept - explain a GRC concept
• /companion:lab - build a learning-safe mini-lab
• /companion:scenario - generate a practice scenario
• /companion:translate - cross-domain pattern translation
• /companion:path - design a learning path

Cursor

Cursor

Drop a .cursor/rules/ file into any workspace where you want the Companion available.

Prerequisites

• Cursor installed.
• git installed.

Install

# 1. Clone the Companion repo if you have not already
mkdir -p ~/Tools && cd ~/Tools
git clone https://github.com/grcengineering/companion.git

# 2. Inside the workspace you want to use the Companion in:
cd /path/to/your-workspace
mkdir -p .cursor/rules
cp ~/Tools/companion/dist/adapters/cursor/.cursor/rules/companion.mdc .cursor/rules/companion.mdc

Verify

1. Open the workspace in Cursor.
2. Open Cursor Composer. On macOS, use Cmd+I.
3. Ask: "Apply the GRC Companion rule and ask me what I want to learn from."
4. The Companion persona should respond. If it does not, confirm the file exists at .cursor/rules/companion.mdc and that Cursor's rules feature is enabled.

Note: The Cursor rule is alwaysApply: false, so you invoke it intentionally per chat by referencing "the GRC Companion rule" in your message.

Claude Projects

Claude Projects (no terminal needed)

Upload the Companion bundle to a Claude Project and use it in the browser.

Prerequisites

• Claude.ai account with Projects access.

Install

1. Go to Claude.ai and create a new Project. Name it "GRC Companion".
2. Download the Companion repo as a zip from https://github.com/grcengineering/companion/archive/refs/heads/main.zip and unzip locally.
3. From the unzipped folder, open dist/adapters/claude-projects/companion-instructions.md. Copy its contents into the Project's custom instructions field.
4. Upload these folders to the Project's knowledge base:
   • dist/adapters/claude-projects/knowledge/
   • dist/adapters/claude-projects/profile/
   • dist/adapters/claude-projects/demos/

Verify

Start a new chat in the Project. Ask: "What real GRC work can we learn from today?" The Companion should ask clarifying questions and reference the corpus.

Codex

Codex

Point a Codex session at the Companion bundle directory.

Prerequisites

• Codex CLI installed and authenticated.
• git installed.

Install

mkdir -p ~/Tools && cd ~/Tools
git clone https://github.com/grcengineering/companion.git

# Start a Codex session inside the adapter bundle
cd ~/Tools/companion/dist/adapters/codex
codex

The bundle's AGENTS.md is the entry point. Codex picks it up automatically when started from this directory.

Verify

Ask in the Codex session: "Read AGENTS.md and tell me which skill you would use if I just finished a vendor review questionnaire and want to learn from it."

Codex should name task-retrospective and ask for the artefact.