Asuku

asuku

macOS menu bar app for managing [Claude Code](https://docs.anthropic.com/en/docs/claude-code) permission requests via native notifications.

When Claude Code needs permission to run a tool (Bash, Write, Edit, etc.), asuku delivers it as a macOS notification with Allow / Deny actions. You can also respond from your iPhone via [ntfy](https://ntfy.sh).

[Japanese / 日本語](README-jp.md)

Features

• macOS notifications — Alert-style with Allow / Deny actions
• Menu bar UI — Pending requests, quick actions, recent activity
• iPhone notifications — Respond remotely via ntfy + Cloudflare Tunnel (opt-in)
• Auto Approve — Optionally allow every permission request immediately (disabled by default)
• Auto-deny timeout — Automatically denies after 280s
• Sensitive data masking — Tokens and API keys are masked in notifications
• One-click hook install — Registers hooks in Claude Code settings
• Launch at login

Requirements

• macOS 14.0 (Sonoma) or later
• Claude Code installed

Getting Started

1. Install

brew tap ushironoko/tap
brew install --cask asuku

**Note:** asuku is ad-hoc signed (not notarized by Apple). If macOS Gatekeeper blocks the app on first launch, run:

xattr -cr /Applications/asuku.app

2. Install the hook

Click **"Install Hook..."** in the menu bar dropdown, or go to **Settings → Install Hook to Claude Code**.

This registers asuku as a [Claude Code hook](https://docs.anthropic.com/en/docs/claude-code/hooks) in `~/.claude/settings.json`.

3. Configure notifications

On first launch, grant notification permission when prompted. Then go to **System Settings → Notifications → asuku** and set the style to **Alerts** (not Banners) so that Allow / Deny buttons are always visible.

4. Use it

Start Claude Code as usual. When it needs permission, you'll see:

• A macOS notification with Allow / Deny buttons
• The requ