fantasy-claude 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 itsAlfantasy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# claude-hooks
+
+Configurable statusline and sound hooks for [Claude Code](https://claude.ai/code).
+
+## Features
+
+- **Statusline**: compose your status bar with modular elements (git branch, cwd, time, battery, …)
+- **Sound hooks**: play sounds on tool errors, stop, or notifications — sounds are bundled, no downloads needed
+
+## Install
+
+```bash
+git clone https://github.com/yourusername/claude-hooks.git
+cd claude-hooks
+bash install.sh
+```
+
+Then restart Claude Code.
+
+## Configuration
+
+### Interactive configurator
+
+Run the TUI configurator to change settings without editing JSON:
+
+```bash
+bash configure.sh
+```
+
+Use `↑↓` to navigate, `Enter` to select, `←` to go back, `q` to quit.
+Changes are written to `config.json` immediately on confirmation.
+
+### Manual config
+
+Edit `config.json` directly to customize:
+
+```json
+{
+  "statusline": {
+    "elements": ["git-branch", "cwd", "datetime"]
+  },
+  "sounds": {
+    "on_error": "lego-break",
+    "on_stop": null,
+    "on_notification": null
+  }
+}
+```
+
+### Statusline elements
+
+| Element | Description |
+|---|---|
+| `git-branch` | Current git branch |
+| `cwd` | Current working directory |
+| `datetime` | Current time (HH:MM) |
+| `battery` | Battery percentage |
+
+To add a custom element, create a script in `statusline/elements/<name>.sh` that prints a single line, then add `<name>` to the `elements` array in `config.json`.
+
+### Sounds
+
+Place `.mp3` files in:
+- `sounds/error/` — for `on_error`
+- `sounds/notification/` — for `on_stop` and `on_notification`
+
+Then set the filename (without extension) in `config.json`. Set to `null` to disable.
+
+**Supported events:**
+
+| Event | When |
+|---|---|
+| `on_error` | A tool call returns an error |
+| `on_stop` | Claude finishes a response |
+| `on_notification` | Claude sends a notification |
+
+## Platform support
+
+- macOS: `afplay`
+- Linux: `paplay` or `aplay`

package/VERSION

@@ -0,0 +1 @@
+1.0.3

package/cli.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+case "${1:-}" in
+  install)   exec bash "$SCRIPT_DIR/install.sh" ;;
+  --version) cat "$SCRIPT_DIR/VERSION" ;;
+  *)         exec python3 "$SCRIPT_DIR/configure.py" ;;
+esac

package/config.json

@@ -0,0 +1,135 @@
+{
+  "statusline": {
+    "default_color": null,
+    "separator_color": null,
+    "lines": [
+      [
+        "model",
+        "cwd",
+        "git-branch"
+      ],
+      [
+        "context-pct",
+        "burn-rate",
+        "session-cost"
+      ]
+    ],
+    "element_settings": {
+      "burn-rate": {
+        "emoji": true,
+        "label": false,
+        "color": "orange"
+      },
+      "cwd": {
+        "emoji": true,
+        "label": false,
+        "color": null,
+        "bar": "off",
+        "basename_only": true
+      },
+      "git-branch": {
+        "emoji": true,
+        "label": false,
+        "color": null,
+        "bar": "off"
+      },
+      "battery": {
+        "emoji": true,
+        "label": false,
+        "color": null,
+        "bar": "mono"
+      },
+      "context-pct": {
+        "emoji": true,
+        "label": false,
+        "color": "orange",
+        "bar": "multi"
+      },
+      "datetime": {
+        "emoji": true,
+        "label": false,
+        "color": null
+      },
+      "reset-time": {
+        "emoji": true,
+        "label": false,
+        "color": null
+      },
+      "session-cost": {
+        "emoji": true,
+        "label": false,
+        "color": "orange",
+        "bar": "off"
+      },
+      "session-duration": {
+        "emoji": true,
+        "label": false,
+        "color": null
+      },
+      "usage-5h": {
+        "emoji": false,
+        "label": true,
+        "color": "green",
+        "bar": "multi"
+      },
+      "model": {
+        "emoji": true,
+        "label": false,
+        "color": null,
+        "bar": "off",
+        "emoji_set": 2
+      },
+      "github-repo": {
+        "emoji": true,
+        "label": false,
+        "color": null,
+        "bar": "off"
+      },
+      "mood": {
+        "emoji": false,
+        "label": false,
+        "color": null,
+        "bar": "off",
+        "mood_set": 1
+      },
+      "streak": {
+        "emoji": true,
+        "label": false,
+        "color": null,
+        "bar": "off",
+        "show_unit": true
+      },
+      "pomodoro": {
+        "emoji": true,
+        "label": false,
+        "color": null,
+        "bar": "off",
+        "duration": 20
+      },
+      "file-entropy": {
+        "emoji": true,
+        "label": false,
+        "color": null,
+        "bar": "off"
+      },
+      "moon-phase": {
+        "emoji": false,
+        "label": false,
+        "color": null,
+        "bar": "off",
+        "show_name": true
+      },
+      "haiku": {
+        "emoji": false,
+        "label": false,
+        "color": null,
+        "bar": "off"
+      }
+    }
+  },
+  "sounds": {
+    "on_error": "lego-break",
+    "on_stop": null,
+    "on_notification": null
+  }
+}