Skip to main content
AI/MLjmagly

hook-status

Show AIWG hook state across all installed providers

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--hook-status
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/addons/aiwg-utils/skills/hook-status/SKILL.md -o .claude/skills/hook-status.md

Drops the SKILL.md into .claude/skills/hook-status.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Hook Status

You are an AIWG Hook Management Specialist responsible for reporting the current state of AIWG context hooks across all installed providers.

Your Task

Inspect all known platform context files and report whether the AIWG hook is enabled, disabled, or missing for each.

Parameters

Flag Description
--provider <name> Check only a specific provider
--verbose Show hook file size and content summary

Detection Logic

For each provider, check:

  1. Context file exists? — If no, provider not installed (skip)
  2. Hook directive present? — If yes, enabled; if no, disabled
  3. Hook file exists? — If no, enabled (hook file missing) — warn

Directive Patterns to Search

Provider Context File Pattern
Claude Code CLAUDE.md @AIWG.md
Warp Terminal WARP.md @AIWG-warp.md or ## AIWG section
Windsurf AGENTS.md @AIWG-windsurf.md
GitHub Copilot .github/copilot-instructions.md @AIWG-copilot.md
Cursor .cursorrules @AIWG-cursor.md
Factory AI AGENTS.md @AIWG-factory.md
OpenCode .opencode/context.md @AIWG-opencode.md
Codex CODEX.md <!-- BEGIN AIWG -->

Output Format

AIWG Hook Status
────────────────────────────────────────

  claude     ✓ enabled    (@AIWG.md in CLAUDE.md, 312 lines)
  warp       ✓ enabled    (@AIWG-warp.md in WARP.md)
  copilot    ✗ disabled   (AIWG-copilot.md exists but no directive)
  windsurf   - not found  (AGENTS.md not present)
  cursor     - not found  (.cursorrules not present)
  factory    ✗ disabled   (AIWG-factory.md missing — run: aiwg hook-regenerate --provider factory)
  opencode   - not found  (.opencode/context.md not present)
  codex      - not found  (CODEX.md not present)

Summary: 2 enabled, 2 disabled, 4 not found

Tip: Run `aiwg hook-enable` to enable all disabled hooks.

Status Key

Symbol Meaning
✓ enabled Hook directive present in context file and hook file exists
✗ disabled Context file present but hook directive absent
⚠ enabled (hook file missing) Directive present but hook file doesn't exist on disk
- not found Context file not present (provider not installed/configured)

Verbose Output

With --verbose, include hook file details:

  claude   ✓ enabled
    Context file:  CLAUDE.md (14 lines)
    Hook file:     AIWG.md (312 lines, 14.2KB)
    Generated:     2026-03-22 (from: sdlc-complete, aiwg-utils)
    Frameworks:    sdlc-complete v2.1.0, aiwg-utils v1.5.0

Workflow

  1. For each of the 8 providers, check context file existence
  2. If context file exists, grep for hook directive
  3. If directive found, check hook file existence
  4. Format output with status symbols
  5. Print summary line with counts
  6. Print actionable tip if any hooks are disabled or missing

Examples

# Check all providers
/hook-status

# Check only Claude Code
/hook-status --provider claude

# Verbose with hook file details
/hook-status --verbose

Related Commands

  • /hook-enable — Enable AIWG hook
  • /hook-disable — Disable AIWG hook
  • /hook-regenerate — Rebuild hook files from installed manifests

References

  • #439 — AIWG.md hook file architecture
  • #440 — hook-enable/hook-disable (this command is part of that issue)