Aiwg hook-status

Show AIWG hook state across all installed providers

install

source · Clone the upstream repo

git clone https://github.com/jmagly/aiwg

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/agentic/code/addons/aiwg-utils/skills/hook-status" ~/.claude/skills/jmagly-aiwg-hook-status-ceae3a && rm -rf "$T"

manifest: agentic/code/addons/aiwg-utils/skills/hook-status/SKILL.md

source content

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:

Context file exists? — If no, provider not installed (skip)
Hook directive present? — If yes,
```
enabled
```
; if no,
```
disabled
```
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

For each of the 8 providers, check context file existence
If context file exists, grep for hook directive
If directive found, check hook file existence
Format output with status symbols
Print summary line with counts
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)