session-tools

Claude Code Plugins

A curated collection of plugins for Claude Code (Anthropic's official CLI tool). These plugins enhance your Claude Code experience with notifications, task management, permission synchronization, and more.

Table of Contents

• Installation
• Plugins Overview
• Plugin Details
  • notifications
  • task-master
  • mcp-servers
  • permission-sync
  • knowledge-sync
  • session-tools
  • claude-initializer
• Knowledge Repository
• Usage in Projects
• Configuration
• Contributing

---

Installation

Step 1: Add the Marketplace

In Claude Code, run /plugin and select Add marketplace:

qazuor/claude-code-plugins

Step 2: Install Plugins

After adding the marketplace, install the plugins you want:

/plugin → Install plugin → Select from qazuor-claude-code-plugins

Recommended minimum:

• notifications - Audio feedback when Claude finishes
• permission-sync - Keep permissions consistent across projects
• task-master - If you work with specs and tasks

Step 3: Restart Claude Code

Some plugins register hooks that only activate on session start. Restart Claude Code after installing.

---

Plugins Overview

Plugin	Purpose	Auto-runs
notifications	Desktop notifications + audio beeps	On events
task-master	Specs, tasks, progress tracking	SessionStart
mcp-servers	30 pre-configured MCP servers	Manual
permission-sync	Sync permissions across projects	SessionStart
knowledge-sync	Sync agents/skills from external repo	SessionStart
session-tools	Diary entries before compaction	PreCompact
claude-initializer	Initialize new projects	Manual

---

Plugin Details

notifications

Purpose: Audio and visual feedback when Claude Code needs your attention.

What it does:

• Plays a beep (1000Hz) when main session stops
• Plays a lower beep (800Hz) when subagents finish
• Shows desktop notifications with optional TTS (text-to-speech)

What it doesn't do:

• No configuration needed
• No commands to run

Hooks:

Event	Action
Notification	Desktop notification + TTS
Stop	1000Hz beep (0.2s)
SubagentStop	800Hz beep (0.1s)

Requirements: paplay (Linux), afplay (macOS), or PowerShell (Windows/WSL)

---

task-master

Purpose: Specification-driven development with task decomposition, progress tracking, autonomous loops, and guardrails.

What it does:

• Creates formal specifications from requirements
• Decomposes specs into atomic, scored tasks with dependencies
• Tracks progress with visual dashboards
• Runs quality gates (lint, typecheck, tests) before completion
• Detects active work on session start
• Autonomous loop for processing tasks sequentially without manual intervention
• Guardrails system with learned constraints for safe autonomous execution

What it doesn't do:

• Doesn't replace your project management tool
• Doesn't auto-commit or push code

Commands:

Command	Description
/spec	Create a specification from requirements
/tasks	Show task dashboard with progress
/next-task	Get the next available task
/new-task	Create a standalone task (no spec needed)
/task-status	Detailed progress report
/replan	Modify tasks when requirements change
/auto-loop	Start autonomous task processing loop
/auto-loop-cancel	Cancel an active autonomous loop

Autonomous Loop:

The /auto-loop command starts a controlled loop that processes tasks one after another:

• Configurable max iterations (default 10)
• Pauses at phase boundaries for review
• Respects guardrails throughout execution
• Stop hook continues loop across session boundaries
• Quality gate checks before each task completion

Guardrails:

Learned constraints stored in .claude/guardrails.md:

• Append-only signs that guide autonomous execution
• 4 seed signs included by default (quality gates, state consistency, documentation, focused changes)
• Add project-specific guardrails as you learn