mcp-voice-hooks/CONTRIBUTING.md

Real-time voice interaction for Claude Code. Speak naturally while Claude works - interrupt, redirect, or provide continuous feedback without stopping.

# Contributing to MCP Voice Hooks

## Local Development

1. Clone and install:
   ```bash
   git clone https://github.com/johnmatthewtennant/mcp-voice-hooks.git
   cd mcp-voice-hooks
   npm install
   npm link
   npx mcp-voice-hooks install-hooks
   ```

2. Start developing:
   ```bash
   npm run build  # After changing TypeScript files
   claude         # Restart to test changes
   ```

**Important**: Claude runs compiled JavaScript from `dist/`, not TypeScript source. Run `npm run build` after changing `.ts` files. Browser files (`public/*`) just need Claude restart.

## Debug Mode

Enable debug logging to see detailed server output:

```bash
npx mcp-voice-hooks --debug
# or
npx mcp-voice-hooks -d
```

This is useful for troubleshooting issues during development.

## Release

```bash
npm run release  # Bumps version, syncs plugins, pushes with tags
```

For minor/major versions:
```bash
npm version minor && git push --follow-tags
npm version major && git push --follow-tags
```