diff --git a/examples/README.md b/examples/README.md index a574e8e..786868a 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1,3 +1,9 @@ +--- +title: "Claude Code Examples" +description: "Annotated templates teaching why patterns work, with trade-offs and alternatives" +tags: [template, reference, workflows, architecture] +--- + # Claude Code Examples Annotated templates that teach you **why** patterns work, not just how to configure them. Each template includes comments explaining trade-offs, alternatives, and when to deviate. diff --git a/examples/agents/analytics-with-eval/README.md b/examples/agents/analytics-with-eval/README.md index 082c869..2708766 100644 --- a/examples/agents/analytics-with-eval/README.md +++ b/examples/agents/analytics-with-eval/README.md @@ -1,3 +1,9 @@ +--- +title: "Analytics Agent with Built-in Evaluation" +description: "Production-ready analytics agent with automated metrics collection and safety validation" +tags: [agents, template, testing, performance] +--- + # Analytics Agent with Built-in Evaluation **Template**: Production-ready analytics agent with automated metrics collection diff --git a/examples/github-actions/README.md b/examples/github-actions/README.md index c3a5c89..9ae2d4e 100644 --- a/examples/github-actions/README.md +++ b/examples/github-actions/README.md @@ -1,3 +1,9 @@ +--- +title: "GitHub Actions Workflows for Claude Code" +description: "Ready-to-use CI/CD workflows integrating Claude Code into GitHub Actions" +tags: [ci-cd, devops, template, workflows] +--- + # GitHub Actions Workflows for Claude Code Ready-to-use GitHub Actions workflows that integrate Claude Code into your CI/CD pipeline. diff --git a/examples/hooks/README.md b/examples/hooks/README.md index 2529912..02c112f 100644 --- a/examples/hooks/README.md +++ b/examples/hooks/README.md @@ -1,3 +1,9 @@ +--- +title: "Claude Code Hooks" +description: "Event-driven scripts for automation, security blocking, and context enrichment" +tags: [hooks, security, template, config] +--- + # Claude Code Hooks Hooks are scripts that execute automatically on Claude Code events. They enable automation, block dangerous operations, and enrich context. @@ -349,6 +355,10 @@ session-summary-config log 5 # Last 5 session summaries - `ccusage` (optional, for accurate cost calculation) - `rtk` (optional, for token savings tracking) +**Screenshot** (real session output): + +![Session Summary v3](../../docs/images/session-summary-v3.png) + **Example Output** (all sections enabled): ``` ═══ Session Summary ═══════════════════ @@ -398,6 +408,21 @@ Turns: 12 (8 interactive · 4 auto) · Avg 6.7s/turn **Quick Install**: `~/.claude/hooks/session-summary-config.sh install` (copies hooks + updates settings.json) +**How it compares to tweakcc's `/cost` patch**: + +[tweakcc](https://github.com/Piebald-AI/tweakcc) (1K+ stars) patches Claude Code's `cli.js` to re-enable `/cost` for Pro/Max subscribers. Different approach, different trade-offs: + +| | tweakcc `/cost` | session-summary.sh | +|---|---|---| +| Approach | Patches Claude Code binary | Official hooks API (no modification) | +| Survives CC updates | No (re-apply each update) | Yes | +| Trigger | Manual (`/cost` command) | Automatic on session exit | +| Metrics | Cost, duration, tokens, LOC | 15 sections (cost, tokens, tools, errors, files, features, git diff, LOC, cache, RTK, ratio...) | +| History | No | JSONL log with all metrics | +| Dependencies | Node.js | jq (bash native) | + +tweakcc is a broader tool (themes, prompts, toolsets) — the `/cost` patch is one feature among many. This hook focuses specifically on session analytics with deeper metrics and zero modification of Claude Code internals. + ### auto-format.sh / auto-format.ps1 **Event**: `PostToolUse` (Edit, Write) diff --git a/examples/integrations/agent-vibes/README.md b/examples/integrations/agent-vibes/README.md index 8b1897e..6502729 100644 --- a/examples/integrations/agent-vibes/README.md +++ b/examples/integrations/agent-vibes/README.md @@ -1,3 +1,9 @@ +--- +title: "Agent Vibes TTS - Text-to-Speech for Claude Code" +description: "Community MCP server adding text-to-speech capabilities to Claude Code" +tags: [mcp, integration, plugin] +--- + # Agent Vibes TTS - Text-to-Speech for Claude Code **Status**: Community MCP Server (optional) diff --git a/examples/modes/README.md b/examples/modes/README.md index 16d9475..1b8e52b 100644 --- a/examples/modes/README.md +++ b/examples/modes/README.md @@ -1,3 +1,9 @@ +--- +title: "Behavioral Modes" +description: "Ready-to-use behavioral mode files for customizing Claude Code behavior" +tags: [config, template, workflows] +--- + # Behavioral Modes Ready-to-use behavioral mode files for Claude Code. Copy to `~/.claude/` and reference in your `CLAUDE.md`. diff --git a/examples/scripts/README.md b/examples/scripts/README.md index afd0bf6..7898767 100644 --- a/examples/scripts/README.md +++ b/examples/scripts/README.md @@ -1,3 +1,9 @@ +--- +title: "Scripts" +description: "Utility scripts for Claude Code power users: audits, health checks, and session management" +tags: [template, debugging, security, workflows] +--- + # Scripts Utility scripts for Claude Code power users.