-
Notifications
You must be signed in to change notification settings - Fork 155
setup-claude-hooks.sh script missing despite being referenced in documentation (regression from PR #33) #50
Description
Labels: bug, documentation, regression
Body:
Problem Description
The setup-claude-hooks.sh script is referenced throughout the documentation but is missing from the repository,
preventing users from setting up multi-agent file locking functionality.
Steps to Reproduce
- Clone the repository: git clone https://github.com/rinadelph/Agent-MCP.git
- Follow the getting started guide: uv venv && uv pip install -e .
- Try to run: ./setup-claude-hooks.sh
- Result: ./setup-claude-hooks.sh: No such file or directory
Expected Behavior
The setup-claude-hooks.sh script should exist and configure Claude Code hooks for multi-agent file locking as
documented.
Current Impact
- Multi-agent file locking is non-functional for new users
- Documentation is broken - references non-existent script 5+ times
- Poor first-time user experience - setup instructions fail
- Core functionality unavailable - agents can't coordinate file access
Root Cause Analysis
This appears to be a regression from PR #33:
- Issue #32 documented the same problem (missing setup script)
- PR #33 allegedly fixed it by adding setup-claude-hooks.sh
- PR was merged on July 14, 2025 and marked as resolved
- Script is now missing from main branch (regression occurred)
Evidence of Regression
Documentation still references the script:
- docs/getting-started.md: ./setup-claude-hooks.sh
- CONTRIBUTING.md: ./setup-claude-hooks.sh
- Multiple troubleshooting sections mention it
PR #33 Details:
- Claimed to add ✨ setup-claude-hooks.sh - New automated setup script
- Issue #32 was marked "RESOLVED" with comment about merged PR #33
- But the file is missing from current main branch
Environment
- Date Discovered: December 8, 2024
- Branch: main (latest)
- OS: Windows (affects all platforms)
- Python: 3.14.0
- Installation method: uv venv && uv pip install -e .
Suggested Fix
Either:
- Restore the missing script from PR #33 history
- Recreate the script based on the template in agent_mcp/templates/agent_startup.sh
- Update documentation to remove references if script is intentionally removed
Workaround
Currently there is no workaround - multi-agent file locking functionality is completely unavailable to new users.
Additional Context
The agent_mcp/templates/agent_startup.sh file exists and shows the expected structure for tmux-based agent sessions,
suggesting the setup script should configure Claude Code hooks to integrate with this system.
This regression affects every new user trying to use Agent-MCP's core multi-agent collaboration features.