This project provides a daemon-first Discord notification router designed to bypass gateway sessions, preventing context pollution and offering a clean separation of rendering and delivery. It targets developers and power users who need a flexible, typed event pipeline to route notifications from various sources like Git, GitHub, tmux, and agent lifecycles to Discord or Slack channels. The primary benefit is a robust, configurable notification system that integrates seamlessly with development workflows, particularly those involving AI coding assistants like OMX and OMC.

How It Works

Clawhip operates as a daemon that ingests events from multiple sources, including CLI commands, webhooks, Git monitors, and tmux sessions. Events are processed through an MPSC queue, dispatched, and then routed based on configurable rules defined in config.toml. The routing logic matches event families and payload filters, directing them to specified sinks (Discord, Slack) with customizable formats and mentions. A key architectural choice is the separation of concerns between the router, renderer, and sink, enabling flexibility. It also supports a filesystem-offloaded memory pattern for durable state management and integrates tightly with tools like OMX/OMC by processing session.* events.

Quick Start & Requirements

Installation can be done via cargo install clawhip (requires Rust toolchain), using a recommended prebuilt binary installer script (curl ... | sh), or via a repo-local ./install.sh script. Runtime commands include clawhip install, clawhip update, and clawhip uninstall. Prerequisites include a Discord bot token or webhook URL, or a Slack webhook URL. Official documentation links are available within the README for architecture, event contracts, memory offloading, and specific integrations.

Highlighted Details

• v0.4.0 Enhancements: Introduced repo-local installs, optional GitHub star prompts, filesystem memory scaffolds (clawhip memory init/status), and refined native session contracts favoring the session.* route family.
• Coding Assistant Integration: Pairs effectively with OMX (OpenAI Codex) and OMC (Claude Code) wrappers, routing session.* events and supporting native hook forwarding.
• Flexible Event Routing: Supports a wide array of event families including github.*, git.*, agent.*, session.*, and tmux.*, with granular filtering and dynamic token support in message formats.
• Filesystem Memory: Implements a durable memory pattern using MEMORY.md and filesystem shards for persistent project, channel, and daily state.
• Plugin Architecture: Features a simple plugin system for tool-specific shell bridges, with starter plugins for Codex and Claude Code.

Maintenance & Community

The project is primarily maintained by Yeachan-Heo. The README does not explicitly mention community channels like Discord or Slack, nor does it detail a roadmap or list other notable contributors or sponsorships.

Licensing & Compatibility

The specific open-source license for this project is not stated in the README. Prebuilt binaries are available for x86_64-unknown-linux-gnu, aarch64-unknown-linux-gnu, x86_64-apple-darwin, aarch64-apple-darwin, and x86_64-pc-windows-msvc. Compatibility is focused on integration with development tools and notification delivery to Discord and Slack.

Limitations & Caveats

The absence of explicit licensing information is a significant adoption blocker, preventing clear assessment of commercial use or derivative works. Community engagement channels are not readily apparent, and detailed setup beyond basic installation may require consulting multiple linked documentation files. The project appears to be under active development, with recent releases focusing on core features and integrations.