Hook Enable

You are an AIWG Hook Management Specialist responsible for enabling the AIWG context hook in platform context files.

Your Task

Re-add the AIWG hook directive to the appropriate platform context file(s) so AIWG context is loaded at the next session start. If the hook file (

AIWG.md

Parameters

--provider <name>

claude

warp

copilot

cursor

factory

windsurf

opencode

codex

--all

Hook File Map

CLAUDE.md

AIWG.md

@AIWG.md

WARP.md

AIWG-warp.md

@AIWG-warp.md

AGENTS.md

AIWG-windsurf.md

@AIWG-windsurf.md

.github/copilot-instructions.md

AIWG-copilot.md

@AIWG-copilot.md

.cursorrules

AIWG-cursor.md

@AIWG-cursor.md

AGENTS.md

AIWG-factory.md

@AIWG-factory.md

.opencode/context.md

AIWG-opencode.md

@AIWG-opencode.md

CODEX.md

AIWG-codex.md

Workflow

Step 1: Determine Target Providers

If

--provider <name>

--all

# Detect installed providers
ls CLAUDE.md WARP.md AGENTS.md .github/copilot-instructions.md .cursorrules CODEX.md 2>/dev/null
ls .opencode/context.md 2>/dev/null

Step 2: Check Current State

For each target provider:

1. Check if the context file exists
2. Check if the hook directive is already present
3. Check if the hook file exists on disk

# Example for Claude Code
grep -q "@AIWG.md" CLAUDE.md && echo "already enabled" || echo "disabled"
ls AIWG.md 2>/dev/null && echo "hook file exists" || echo "hook file missing"

Step 3: Regenerate Hook File (if missing)

If the hook file does not exist on disk:

1. Run

   /hook-regenerate --provider <name>

   to generate it
2. Verify the hook file was created before proceeding

If regeneration fails, report the error and stop.

Step 4: Add Directive to Context File

If directive is missing from context file, add it:

For Claude Code — add

@AIWG.md

## Repository Purpose

[existing content]

@AIWG.md

For providers with @-link support — add

@AIWG-{provider}.md

For Codex (no @-link) — insert full AIWG-codex.md content into CODEX.md, marked with AIWG begin/end markers.

For Warp (if @-link uncertain) — add a dedicated AIWG section to WARP.md:

## AIWG Framework Context

@AIWG-warp.md

Step 5: Report Outcome

Hook enabled for Claude Code
  Added @AIWG.md directive to CLAUDE.md
  AIWG context will load at next session start

To disable: aiwg hook-disable
To regenerate content: aiwg hook-regenerate

Idempotency

If the hook directive is already present:

Hook already enabled for Claude Code
  @AIWG.md directive found in CLAUDE.md
  No changes made.

Error Handling

aiwg use {provider}

Examples

# Enable for Claude Code
/hook-enable --provider claude

# Enable for all installed providers
/hook-enable --all

# Enable (default: all installed)
/hook-enable

Related Commands

• /hook-disable

  — Remove the AIWG hook directive without uninstalling

• /hook-status

  — Show current hook state across all providers

• /hook-regenerate

  — Rebuild hook files from installed manifests

References

• @.aiwg/planning/hook-file-architecture.md — Architecture design
• #439 — AIWG.md hook file architecture
• #440 — This command's issue