Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

lambdasawa/claude-code-notification

Repository files navigation

Claude Code Notification

A web application that provides rich desktop and audio notifications for Claude Code by watching ~/.claude/projects/.

The primary use case is adding notifications to Claude Code running inside a Sandbox VM (where native desktop notifications aren't available), but it works equally well on the host machine.

Features

  • No hooks required: Automatically watches session files under ~/.claude/projects/
  • Desktop notifications: Browser-based notifications via Web Notification API
  • Audio notifications: Text-to-speech via Web Speech API
  • Activity log: Real-time stream of all Claude Code messages
  • Session browser: Browse projects and conversation history

Usage

npm install
npm run dev

Open http://localhost:3010 in your browser, then:

  1. Click "Listening" to start watching for events
  2. Enable "Desktop Notification" and/or "Speech" as needed
  3. Keep the tab open while working with Claude Code

For Sandbox VM

Run the app inside the VM and access it from the host browser via port forwarding.

┌─────────────────────────────────────────────────────────────────┐
│ Sandbox VM │
│ ┌─────────────┐ ┌──────────────────────────────────────┐ │
│ │ Claude Code │ ──── │ This App (watches ~/.claude) │ │
│ └─────────────┘ └──────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
 │ Port forwarding
 ▼
┌───────────────────────────────────────────────────────────────────┐
│ Host: Browser → Desktop notifications / Speech │
└───────────────────────────────────────────────────────────────────┘

Environment Variables

  • PORT - Server port (default: 3010)

Requirements

  • Node.js 24+

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

AltStyle によって変換されたページ (->オリジナル) /