Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/rinadelph/rins_hooks

rins_hooks - Never lose track of your Claude Code changes again. Automatically commits every edit with context, so you can code fearlessly and revert easily.
https://github.com/rinadelph/rins_hooks

Last synced: 2 months ago
JSON representation

rins_hooks - Never lose track of your Claude Code changes again. Automatically commits every edit with context, so you can code fearlessly and revert easily.

Awesome Lists containing this project

README 

          
# rins_hooks



Universal Claude Code hooks collection with cross-platform installer



> šŸ¤– **Interested in AI Multi-Agent workflows?** Join the [Swarm Community](https://discord.gg/7Jm7nrhjGn) to discuss agentic development, share tools, and collaborate on building better AI workflows!



## šŸŒ Cross-Platform Support



Works universally across all devices and operating systems:

- āœ… **Windows** (10, 11) - Native PowerShell integration

- āœ… **macOS** (Intel & Apple Silicon) - Native osascript notifications  

- āœ… **Linux** (Ubuntu, CentOS, Arch) - Native notify-send support

- āœ… **Node.js** 16+ - Tested on LTS versions



## šŸš€ Quick Start



Install globally with npm:



```bash

npm install -g rins_hooks

```



Install hooks interactively:



```bash

rins_hooks install --interactive

```



Or install specific hooks:



```bash

rins_hooks install auto-commit code-formatter notification

```



## šŸ“‹ Available Hooks



### šŸ”„ Auto-Commit Hook

Automatically commits file changes with contextual messages after every Claude Code file modification.



**Features:**

- Smart commit messages with tool context

- File path and change type detection

- Configurable exclusion patterns

- Branch-aware behavior



### šŸŽØ Code Formatter Hook

Automatically formats code after file modifications using popular formatters.



**Features:**

- Support for multiple languages (JS/TS, Python, Go, Rust, Java, C/C++)

- Project configuration detection

- Configurable formatters per file type

- Graceful error handling



### šŸ”” Notification Hook

Enhanced notifications for Claude Code events with multiple delivery methods.



**Features:**

- Cross-platform desktop notifications

- Slack/Discord/Teams integration

- Custom notification commands

- Configurable notification types



## šŸ“– Installation Options



### Global Installation (Recommended)

Install for all Claude Code projects:

```bash

rins_hooks install auto-commit --user

```



### Project Installation

Install for current project only:

```bash

rins_hooks install auto-commit --project

```



### Local Installation

Install locally (not committed to git):

```bash

rins_hooks install auto-commit --local

```



## šŸ”§ Commands



### Installation

```bash

# Interactive installation

rins_hooks install --interactive



# Install specific hooks

rins_hooks install auto-commit notification



# Install all hooks

rins_hooks install --all



# Dry run (preview changes)

rins_hooks install auto-commit --dry-run

```



### Management

```bash

# List available hooks

rins_hooks list



# Show installation status

rins_hooks status



# Show configuration

rins_hooks config --show



# Validate configuration

rins_hooks config --validate



# Run diagnostics

rins_hooks doctor

```



### Uninstallation

```bash

# Uninstall specific hooks

rins_hooks uninstall auto-commit



# Uninstall all hooks

rins_hooks uninstall --all

```



## āš™ļø Configuration



### Auto-Commit Hook Configuration



The auto-commit hook can be customized through its configuration:



```json

{

  "commitMessageTemplate": "Auto-commit: {{toolName}} modified {{fileName}}\\n\\n- File: {{filePath}}\\n- Tool: {{toolName}}\\n- Session: {{sessionId}}\\n\\nšŸ¤– Generated with Claude Code via rins_hooks\\nCo-Authored-By: Claude ",

  "excludePatterns": [

    "*.log", "*.tmp", ".env*", "*.key", "node_modules/**", ".git/**"

  ],

  "skipEmptyCommits": true,

  "branchRestrictions": ["main", "master"],

  "maxCommitMessageLength": 500

}

```



### Code Formatter Configuration



Configure formatters for different file types:



```json

{

  "formatters": {

    ".js": "prettier --write",

    ".py": "black",

    ".go": "gofmt -w",

    ".rs": "rustfmt"

  },

  "excludePatterns": ["node_modules/**", "dist/**"],

  "failOnError": false

}

```



### Notification Configuration



Set up notifications and integrations:



```json

{

  "desktopNotifications": true,

  "integrations": {

    "slack": {

      "enabled": true,

      "webhook": "https://hooks.slack.com/...",

      "channel": "#dev"

    },

    "discord": {

      "enabled": true,

      "webhook": "https://discord.com/api/webhooks/..."

    }

  }

}

```



## šŸ› ļø Requirements



- **Node.js**: >= 16.0.0

- **Claude Code**: Latest version

- **Git**: For auto-commit functionality

- **Formatters**: Optional, based on enabled hooks



## šŸ” Diagnostics



Run the built-in diagnostics to check your setup:



```bash

rins_hooks doctor

```



This will check:

- āœ… Node.js version compatibility

- āœ… Claude Code installation

- āœ… Git availability and repository status

- āœ… Settings directory permissions

- āœ… Configuration file validity



## šŸ“ File Structure



```

~/.claude/                          # Claude Code settings directory

ā”œā”€ā”€ settings.json                   # User-level hooks

ā””ā”€ā”€ projects/

    ā””ā”€ā”€ your-project/

        ā””ā”€ā”€ .claude/

            ā”œā”€ā”€ settings.json       # Project-level hooks

            ā””ā”€ā”€ settings.local.json # Local hooks (not committed)

```



## šŸ”’ Security Considerations



- Hooks execute with your user permissions

- Review hook configurations before installation

- Use project-level installation for team settings

- Keep sensitive configurations in local settings

- Regularly update to latest versions



## šŸ› Troubleshooting



### Common Issues



**Hook not executing:**

```bash

# Check installation status

rins_hooks status



# Validate configuration

rins_hooks config --validate



# Run diagnostics

rins_hooks doctor

```



**Permission errors:**

- Ensure Claude Code settings directory is writable

- Check file permissions on hook scripts

- Verify git repository permissions for auto-commit



**Formatter not found:**

- Install required formatters globally

- Check PATH configuration

- Use `rins_hooks doctor` to verify dependencies



## šŸ¤ Contributing



We welcome contributions! Here's how to get started:



1. Fork the repository

2. Create a feature branch

3. Add your hook or improvement

4. Test thoroughly across platforms

5. Submit a pull request



### Creating Custom Hooks



Extend the `HookBase` class:



```javascript

const HookBase = require('rins_hooks/src/hook-base');



class MyCustomHook extends HookBase {

  constructor(config = {}) {

    super('my-custom-hook', config);

  }



  async execute(input) {

    // Your hook logic here

    return this.success({ message: 'Hook executed successfully' });

  }

}

```



## šŸ“„ License



MIT License - see [LICENSE](LICENSE) file for details.



## šŸ”— Links



- [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)

- [GitHub Repository](https://github.com/your-username/rins_hooks)

- [Issue Tracker](https://github.com/your-username/rins_hooks/issues)

- [NPM Package](https://www.npmjs.com/package/rins_hooks)



## šŸ™ Acknowledgments



- [Anthropic](https://anthropic.com) for Claude Code

- Open source community for formatter tools

- Contributors and testers



---



**Made with ā¤ļø for the Claude Code community**