v1.3.1

What's Changed

Fixed

• Expanded .gitignore with codemunch generated files, editor files, and OS entries

Full Changelog

v1.3.0...v1.3.1

v1.3.0

What's Changed

Fixed

• Replace echo-pipe patterns with herestrings and input redirection in hooks
• Add jq availability guard to PreToolUse hook
• Add gh/timeout guards to SessionStart hook for portability

Added

• CLAUDE.md with release checklist rules
• CHANGELOG.md backfilled for all versions
• .gitignore for generated files
• Upgrade instructions for users with stale installs

Fixed

• VERSION file updated (was stuck at 1.1.0)

Full Changelog

v1.2.0...v1.3.0

v1.2.0 — Auto-update check & upgrade command

What's new

Auto-update check on startup

• codemunch now checks for new releases once per day when you start a session
• Lightweight: single GitHub API call, 3s timeout, 24h cache — never blocks startup
• If an update is available, you'll see: Update available: v1.1.0 → v1.2.0

/codemunch:upgrade command

• Run /codemunch:upgrade to check for and install the latest version
• Shows the changelog after upgrading

Full changelog

Added

• commands/upgrade.md — /codemunch:upgrade command
• hooks/sessionstart.sh — SessionStart update check hook
• VERSION file — tracks installed version for comparison

Changed

• .claude-plugin/hooks/hooks.json — registered SessionStart hook
• README: added auto-update docs, upgrade command, updated plugin structure

v1.1.0

What's New

PreToolUse enforcement hook

• Programmatically nudges Claude toward codemunch commands when it tries to Read/Grep/Glob source files
• Achieves ~98% enforcement vs ~60-80% with CLAUDE.md instructions alone
• Disableable via /codemunch:disable command

Auto-update check

• SessionStart hook checks GitHub for new releases once per day (3s timeout, 24h cache)
• Users see update notifications directly in the status line
• New /codemunch:upgrade command to install latest version

Disable/Enable commands

• /codemunch:disable — turns off hook + CLAUDE.md enforcement in one step
• /codemunch:enable — turns enforcement back on

context-mode comparison

• README now includes a detailed comparison table vs context-mode

via HAPI

v1.0.0

codemunch v1.0.0

Token-efficient code exploration plugin for Claude Code.

Installation

/plugin marketplace add benmarte/codemunch
/plugin install codemunch@codemunch

Features

• Explore codebase structure without reading full files
• Search for symbols (functions, classes, methods, types) with filters
• Fetch specific symbols instead of entire files — dramatically lower context usage
• Find all references to a symbol across the codebase
• Auto-indexes your project for fast lookups

Commands

• /codemunch:explore [path] — understand project structure, class hierarchies, entry points
• /codemunch:search <query> — find symbols with optional filters (kind:class, file:*.ts)
• /codemunch:fetch <name> — read a specific function/class without loading the full file
• /codemunch:refs <name> — find all references to a symbol
• /codemunch:index — index the project for fast lookups
• /codemunch:init — add codemunch instructions to your project's CLAUDE.md