~ / rigs / aquahitt / claude-code-limit-alerts

aquahitt/claude-code-limit-alerts

Usage-limit alerts for Claude Code: macOS notifications, in-app warnings and statusline percentages for session (5h) and weekly limits

↗ GitHub ★ 1 MIT updated 1mo ago project Claude Code Claude plugin
field: unknown workflow: DocsGit & commitsCI/CD & deploy
share on X
ARCHETYPE
Automator
Hooks on every lifecycle event: format, lint, notify, log.
CONTEXT TAX · EVERY TURN
~2.6k tokens
Moderate · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 15/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit aquahitt/claude-code-limit-alerts/.claude ./rig-claude-code-limit-alerts  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ npx degit aquahitt/claude-code-limit-alerts/.claude/skills/check-scripts .claude/skills/check-scripts
$ npx degit aquahitt/claude-code-limit-alerts/.claude/skills/release .claude/skills/release
$ npx degit aquahitt/claude-code-limit-alerts/.claude/skills/sync-readmes .claude/skills/sync-readmes
$ npx degit aquahitt/claude-code-limit-alerts/skills/setup .claude/skills/setup
$ npx degit aquahitt/claude-code-limit-alerts/skills/status .claude/skills/status
$ npx degit aquahitt/claude-code-limit-alerts/skills/uninstall .claude/skills/uninstall
$ curl -fsSL --create-dirs -o .claude/agents/installer-safety-reviewer.md https://raw.githubusercontent.com/aquahitt/claude-code-limit-alerts/main/.claude/agents/installer-safety-reviewer.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "cmd=\"$CLAUDE_TOOL_INPUT_COMMAND\"; if echo \"$cmd\" | grep -qE 'git (commit|push)'; then echo 'PRE-COMMIT REMINDER: run skill check-scripts (bash -n + shellcheck on changed *.sh) and make sure README.md/README.en.md are in sync before committi"
          }
        ]
      }
    ]
  }
}

Skills (6)

Subagents (1)

installer-safety-reviewer
model: claude-opus-4-7
Reviews changes to install.sh, uninstall.sh, update.sh and lib/hooks.sh for safety before they touch a real user's ~/.claude or launchd

Hooks (5)

eventmatcherruns
PostToolUseEdit|Writefile="$CLAUDE_TOOL_INPUT_FILE_PATH"; if [[ "$file" == *.sh ]]; then out=$(bash -n "$file" 2>&1); if [ $? -ne 0 ]; then echo "BASH SYNTAX ERROR in $file:"; echo "$out"; fi; fi
PostToolUseEdit|Writefile="$CLAUDE_TOOL_INPUT_FILE_PATH"; if [[ "$file" == *.sh ]] && command -v shellcheck >/dev/null 2>&1; then shellcheck -S warning "$file" 2>/dev/null | head -20; fi
PostToolUseEdit|Writefile="$CLAUDE_TOOL_INPUT_FILE_PATH"; if [[ "$file" == */README.md ]]; then echo 'README REMINDER: README.md and README.en.md must stay structurally in sync — check the sections in README.en.md (skill sync-readmes).'; elif [[ "$file" == */RE
PostToolUseEdit|Writefile="$CLAUDE_TOOL_INPUT_FILE_PATH"; if [[ "$file" == */scripts/*.sh || "$file" == */lib/*.sh || "$file" == */install.sh || "$file" == */uninstall.sh || "$file" == */update.sh || "$file" == */launchd/*.template ]]; then echo 'CHANGELOG REMI
PreToolUseBashcmd="$CLAUDE_TOOL_INPUT_COMMAND"; if echo "$cmd" | grep -qE 'git (commit|push)'; then echo 'PRE-COMMIT REMINDER: run skill check-scripts (bash -n + shellcheck on changed *.sh) and make sure README.md/README.en.md are in sync before committi

Permissions

deny (0)
—
ask (0)
—
allow (5)
Bash(bash -n *)
Bash(shellcheck *)
Bash(git status*)
Bash(git diff*)
Bash(git log*)

Similar rigs

copied ✓