Skip to content

setup-claude-hooks.sh script missing despite being referenced in documentation (regression from PR #33) #50

@jcmrs

Description

@jcmrs

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions