Prettier Markdown Hook

Automatically format markdown files with prettier when Claude stops responding, with configurable organization and path exclusions.

Overview

This Claude Code plugin provides a Stop hook that automatically formats markdown files in your workspace using prettier. It runs asynchronously in the background after every conversation, ensuring consistent markdown formatting without interrupting your workflow.

Features

• ✅ Zero-Config Default: Works immediately after installation with sensible defaults
• ✅ Organization Exclusions: Skip formatting for specific GitHub organizations (e.g., company repos)
• ✅ Path Exclusions: Exclude specific directories or file patterns
• ✅ AI Commit Messages: Optional AI-generated commit messages (opt-in)
• ✅ Fire-and-Forget: Async execution (<10ms hook exit time)
• ✅ XDG Compliant: Cross-platform default paths
• ✅ Comprehensive Logging: All operations logged for debugging

How It Works

1. Stop Hook: Triggers after Claude finishes responding
2. Workspace Check: Verifies you're in a git workspace
3. Exclusion Check: Skips excluded organizations/paths
4. Format Files: Runs prettier on modified markdown files
5. Auto Commit: Creates a conventional commit (optional AI message)
6. Background Execution: All processing happens asynchronously

Installation

Prerequisites

Ensure these dependencies are installed and available in your PATH:

# Check dependencies
prettier --version  # 2.0 or higher
jq --version        # 1.6 or higher
git --version       # 1.8.5 or higher

Installation commands:

# macOS (Homebrew)
brew install prettier jq git

# npm/yarn (prettier)
npm install -g prettier
# or
yarn global add prettier

# Linux (Ubuntu/Debian)
apt-get install jq git
npm install -g prettier

Plugin Installation

Via Claude Code Marketplace:

# Add marketplace (if not already added)
/plugin marketplace add https://github.com/jeremylongshore/claude-code-plugins

# Install plugin
/plugin install prettier-markdown-hook

Manual Installation:

# Clone marketplace repository
git clone https://github.com/jeremylongshore/claude-code-plugins

# Copy plugin to Claude Code plugins directory
cp -r claude-code-plugins/plugins/productivity/prettier-markdown-hook \
      ~/.claude/plugins/prettier-markdown-hook

Verification

After installation, the hook will run automatically after Claude stops responding. Check the log file to verify:

# View log file (XDG-compliant path)
tail -f ~/.local/state/prettier-hook/format-markdown.log

# Or custom log location (if configured)
tail -f $PRETTIER_LOG_DIR/format-markdown.log

Configuration

Zero-Config (Default)

No configuration needed! The plugin works out-of-the-box with sensible defaults:

• Formats all markdown files in workspace
• Skips node_modules, .git, .github, .claude/skills, skills, plugins, file-history
• Uses standard prettier formatting
• Conventional commit messages
• Logs to ~/.local/state/prettier-hook/

Custom Configuration

Create ~/.prettierrc-hook.json to customize behavior:

{
  "excludeOrgs": ["Eon-Labs", "CompanyName"],
  "excludePaths": ["docs/archive", "legacy/**/*.md"],
  "logDir": "~/.local/state/prettier-hook"
}

Configuration options:

Example configuration file is provided at config/.prettierrc-hook.json.example.

Environment Variables

Override configuration with environment variables (highest precedence):

# Custom config file location
export PRETTIER_CONFIG=~/my-custom-config.json

# Enable AI-generated commit messages (requires `claude` CLI)
export PRETTIER_ENABLE_AI_COMMITS=true

# Custom log directory
export PRETTIER_LOG_DIR=~/logs/prettier

Precedence: Environment Variables > Config File > Built-in Defaults

Organization Exclusions

Skip formatting for specific GitHub organizations (e.g., employer/client repos):

{
  "excludeOrgs": ["Eon-Labs", "MyCompany", "ClientOrg"]
}

Important: Organization names are case-sensitive and must match exactly:

• ✅ Correct: "Eon-Labs" (matches github.com/Eon-Labs/repo)
• ❌ Wrong: "eonlabs" (will not match)

Path Exclusions

Exclude specific directories or file patterns:

{
  "excludePaths": [
    "docs/archive",
    "legacy/**/*.md",
    "vendor",
    "third-party"
  ]
}

Path exclusions are additive to built-in defaults (not replacements).

AI Commit Messages (Opt-In)

Enable AI-generated commit messages via environment variable:

# In your shell profile (~/.zshrc, ~/.bashrc)
export PRETTIER_ENABLE_AI_COMMITS=true

Requirements:

• claude CLI installed and in PATH
• Environment variable set to true

Default behavior (AI disabled):

style: format markdown files with prettier

AI-generated example: