# cc_helper

**Repository Path**: FullStackDamon/cc_helper

## Basic Information

- **Project Name**: cc_helper
- **Description**: 主要用来 claude code 进行交互的工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-25
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Notification System

Real-time notification system for Claude Code task completion alerts.

## Components

- **Server**: WebSocket server on port 20005 (`server/`)
- **Client**: Windows tray application (Fyne) (`client/`)
- **Hook**: Claude Code Stop hook script (`hook/`)

## Quick Start

### 1. Start Server

```bash
cd server && go run .
```

### 2. Build and Run Client

```bash
cd client && go build -o client.exe && ./client.exe
```

Note: For Windows cross-compilation from Linux:
```bash
cd client && GOOS=windows GOARCH=amd64 go build -o client.exe .
```

### 3. Configure Claude Code Hook

Add to `~/.claude/settings.json`:

```json
{
  "hooks": {
    "Stop": [
      {
        "command": "/path/to/claude_helper/hook/send-notification.sh"
      }
    ]
  }
}
```

## Manual Test

Send a test notification via curl:

```bash
curl -X POST http://localhost:20005/notify \
  -H "Content-Type: application/json" \
  -d '{"level":"info","task_id":"test-001","summary":"Test notification"}'
```

## Message Format

```json
{
  "level": "info|warning|error",
  "task_id": "task-identifier",
  "summary": "Task completion summary..."
}
```

## Architecture

```
Claude Code (Stop hook) → HTTP POST → Server (port 20005) → WebSocket → Client (Tray app)
```

## Environment Variables

Hook script supports these optional environment variables:

- `CLAUDE_TASK_ID` - Custom task identifier
- `CLAUDE_NOTIFICATION_LEVEL` - Override notification level (info/warning/error)