github hyhmrright/brooks-lint v0.8.1
v0.8.1 — Fix short-form slash commands

latest releases: v1.3.0, v1.2.3, v1.2.2...
one month ago

What's New

🔧 Short-Form Slash Commands Now Work

Previously, brooks-lint skills were only accessible via the namespaced format /brooks-lint:brooks-review. This is a Claude Code plugin system limitation — all plugin skills carry a pluginname: namespace prefix.

v0.8.1 fixes this. The session-start hook now auto-installs thin wrapper files to ~/.claude/commands/ on first session start, enabling:

Short Form Full Form Action
/brooks-review /brooks-lint:brooks-review PR code review
/brooks-audit /brooks-lint:brooks-audit Architecture audit
/brooks-debt /brooks-lint:brooks-debt Tech debt assessment
/brooks-test /brooks-lint:brooks-test Test quality review

Both forms work — short-form is auto-installed, full-form always available.

🛡️ Versioned Sentinel File

A sentinel file (~/.claude/commands/.brooks-lint-v0.8.1) tracks which version installed the wrappers. On plugin upgrade, the wrappers auto-refresh — no manual cleanup needed. Old sentinel files are cleaned up automatically.

🍎 macOS Bash 3.2 Compatibility

Replaced declare -A (bash 4+ only) with a case statement in the session-start hook. macOS ships /bin/bash 3.2 by default — the hook now works regardless of which bash version env bash resolves to.

📝 Single Source of Truth

The hook now copies canonical wrapper files from the commands/ directory instead of regenerating from an inline template. This eliminates content drift between the repo files and what gets installed.


Upgrade

# Plugin marketplace users
/plugin update brooks-lint@brooks-lint-marketplace
/reload-plugins

# Manual install users
git pull
cp commands/*.md ~/.claude/commands/

After updating, restart your Claude Code session. The short-form commands will be available immediately.

Note: If you already have custom ~/.claude/commands/brooks-*.md files, the hook will NOT overwrite them. Delete them manually if you want the updated versions.


Changed Files

  • hooks/session-start — auto-install logic with versioned sentinel
  • commands/*.md — simplified to thin skill wrappers
  • CHANGELOG.md — added entries for v0.7.0, v0.8.0, v0.8.1
  • CLAUDE.md, README.md, CONTRIBUTING.md, AGENTS.md, GEMINI.md — updated command references
  • skills/brooks-review/pr-review-guide.md — updated internal reference
  • Version bumped to 0.8.1 across all 5 manifest files

Full Changelog: v0.8.0...v0.8.1

Don't miss a new brooks-lint release

NewReleases is sending notifications on new releases.