Carabiner
Description
Library for building Claude Code hooks that are type-safe, maintainable, and shareable
Installation
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open the source below and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
README
Carabiner - Type-Safe Hooks Framework for Claude Code
[](https://badge.fury.io/js/@carabiner%2Fhooks-core) [](https://www.npmjs.com/package/@carabiner/hooks-core) [](https://opensource.org/licenses/MIT)
A comprehensive TypeScript framework for building type-safe Claude Code hooks, built on top of the official `@anthropic-ai/claude-code` SDK for maximum compatibility and type safety.
🚀 Overview
Transform Claude Code hook development from manual shell scripting to **type-safe, testable, maintainable TypeScript applications**. Built directly on the official Claude Code SDK, this framework ensures full compatibility with all Claude Code features while providing a superior developer experience.
✨ Key Benefits
- 🛡️ SDK Integration: Built on
@anthropic-ai/claude-codefor guaranteed compatibility - 📘 Full Type Safety: Complete TypeScript types for all hooks and tools via the SDK
- 🔧 Multiple APIs: Function-based, Builder pattern, and Declarative approaches
- 🔐 Security: Built-in validators and environment-specific protections
- 🧪 Testing: Complete mock framework and testing utilities
- ⚡ Performance: Fast, efficient hook execution with proper error handling
- 🎯 Tool Scoping: Hooks can target specific tools or run universally
📦 Installation
Quick Start with NPM
# Install core packages
bun add @carabiner/hooks-core @carabiner/types @carabiner/execution
# For development
bun add -d @carabiner/hooks-testing @carabiner/hooks-validatorsAvailable Packages
All packages are available on npm under the `@carabiner` scope:
- Core:
@carabiner/hooks-core- Core hook functionality with SDK integration - Types:
@carabiner/types- TypeScript type definitions - Execution: `@carabiner/exec
Related Skills
Auto Update
Pull the latest ECC repo changes and reinstall the current managed targets.
Ecc Guide
Navigate ECC's current agents, skills, commands, hooks, install profiles, and docs from the live repository su
Epic Claim
Claim an epic issue, stamp coordination state, and sync local ownership.
Epic Publish
Publish a validated epic update back to the issue and local cache.
Epic Review
Mark epic review requested, approved, or changes requested.
Epic Unblock
Sweep blocked epic issues and reopen anything whose dependencies are closed.