claude-code-templates

Function Hooks become Claude Mods. Anthropic renamed the feature, shipped it behind an early-access flag in Claude Code >= 2.1.259, and published the source of its three built-in mods plus the full TypeScript declarations (anthropics/claude-code#91870, mods/). This release aligns the CLI, the catalog and the site with what actually ships.

Install

npx claude-code-templates@latest --mod security/secret-redactor

--mod downloads the whole plugin directory (like a skill) and writes it verbatim to .claude/skills/<name>/, which Claude Code auto-loads as <name>@skills-dir:

.claude/skills/secret-redactor/
├── .claude-plugin/plugin.json   # name, description, userConfig, author, license
├── hooks/
│   ├── hooks.json               # { "modules": ["./secret-redactor.ts"] }
│   └── secret-redactor.ts
└── README.md

Then run Claude Code with the flag:

CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude
# or, for one session with hot reload:
claude --plugin-dir .claude/skills/secret-redactor

--function-hook still works as a hidden alias of --mod.

What changed

CLI

• New --mod <category/name> flag (comma-separated values supported). Recursive download of the plugin directory via the GitHub API, verbatim write, and validation of plugin.json, hooks/hooks.json and that every module listed in modules came down.
• Post-install output explains the flag, claude plugin validate / claude plugin test, and how to set options via pluginConfigs[name].options in user settings.
• Download tracking type is now mod.

Components: 24 mods, all typechecked against Anthropic's real API

• Every mod is now a complete plugin in Anthropic's layout (cli-tool/components/mods/{category}/{name}/).
• The 10 existing modules were rewritten against the real $ API and runtime-tested on Claude Code 2.1.272: $.fs.read, $.http.fetch → {status, ok, text}, $.ui.ask, { deny } / { result } + context, Box/Text UI primitives, { refuse } on plugin.register.
• Options must be declared in plugin.json userConfig and are read from user or managed settings (never project settings). Declared and documented for every mod.
• cli-tool/components/mods/types/claude-code.d.ts (as /plugin-types writes it) plus a tsconfig.json; CI runs tsc on every mod (mods-typecheck.yml).

14 new game mods (games/)

• cc-arcade vendored as-is (MIT, Seza Akgün), with a fix for $.clock.now() returning a Promise in the current API.
• One mod per cc-arcade game with its own slash command: /tetris, /snake, /2048, /minesweeper, /flappy, /pong, /invaders, /typing, /doom, /pet.
• Three originals written for aitmpl: pacman (scatter/chase ghost AI, power pellets, tunnel), tool-defense (a tower defense where every tool call Claude makes spawns an enemy shaped by the tool) and diff-invaders (every Edit/Write's added lines become the alien formation, drawn with the code's own characters).

Site

• /function-hooks → /mods (Beta). Old URLs redirect. A mod's page shows the README and the full file tree; "Send to repo" writes the entire plugin.

The catalog

Function Hooks land in the CLI. This release ships the --function-hook flag, which installs any of the 10 function hooks from the catalog as a local Claude Code plugin.

Function hooks are Claude Code's proposed fifth hook type (anthropics/claude-code#91870): instead of a shell command that can only allow, deny or inject text, you write a TypeScript module whose hooks take ($, e, next) — Express/Koa middleware, but for tool calls. They can rewrite a tool's input, return their own result in place of the tool, keep state, and draw UI.

Install

npx claude-code-templates@latest --function-hook security/secret-redactor

That writes the plugin to .claude/skills/<name>/:

.claude/skills/secret-redactor/
├── .claude-plugin/plugin.json
└── hooks/
    ├── hooks.json          # { "modules": ["./secret-redactor.ts"] }
    └── secret-redactor.ts

Then run Claude Code with the experimental flag:

CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude --plugin-dir .claude/skills/secret-redactor

The 10 hooks

Browse them at aitmpl.com/function-hooks.

Experimental — read this first

Function hooks are not a shipped Claude Code feature. They are a proposal, and the environment variable, the modules key and every $ API name may change.

That said, the engine is already compiled into Claude Code 2.1.266, and we verified it: security/secret-redactor runs unmodified against the real binary, redaction fires on both Bash and Read, and a follow-up command carrying a redacted placeholder is denied before execution.

Two limits worth knowing about secret-redactor: it matches by shape, so PASSWORD=hunter2 passes untouched; and its connection-string pattern stops at the @, so credentials are removed but host, port and database name are not.

The full write-up, including the $ surface found in the 2.1.266 binary: Function Hooks in Claude Code.

Also in this release

• Blog article corrected against a real 2.1.266 binary (#875)
• Function Hooks section, catalog entries and dashboard listing (#867)

Full changelog: https://github.com/davila7/claude-code-templates/compare/v1.29.2...v1.29.5

🎯 Skills Manager: Plugin Skills Support

The Skills Manager Dashboard now detects and displays skills installed from Claude Code plugins!

✨ New Features

• 3-Source Skill Detection: Skills Manager now scans three locations:

  • 📁 Personal: ~/.claude/skills/ - Manually installed skills
  • 📂 Project: .claude/skills/ - Project-specific skills
  • 🔌 Plugin: ~/.claude/plugins/marketplaces/*/plugins/*/skills/*/ - Plugin-installed skills

• Plugin Skills Integration: Skills installed via /plugin install <skill>@<marketplace> now appear automatically in the dashboard

🔧 Improvements

• Fixed Filter Counts: Filter badges now show consistent totals regardless of active filter

  • All (5) shows total count
  • Personal (4) shows personal count
  • Project (0) shows project count
  • Plugin (1) shows plugin count

• Enhanced Logging: Detailed console output for troubleshooting skill detection:

  • Shows directories being scanned
  • Displays marketplace and plugin counts
  • Reports successful skill loads
  • Identifies missing SKILL.md files

📊 Usage

```bash

Launch Skills Manager

npx claude-code-templates@latest --skills-manager

Opens dashboard at http://localhost:3337

Now shows skills from all three sources!

```

🐛 Bug Fixes

• Fixed filter count numbers changing incorrectly when switching filters
• Skills installed from marketplaces now properly detected
• Improved error handling for missing directories

📦 What's Changed

• Added `loadPluginSkills()` method to scan marketplace installations
• Updated `updateStats()` to use total counts instead of filtered counts
• Enhanced logging throughout skill detection process

Full Changelog: https://github.com/davila7/claude-code-templates/compare/v1.28.2...v1.28.3

🤖 Generated with Claude Code

🐳 Docker Sandbox Provider - Version 1.27.0

Execute Claude Code in isolated local Docker containers with complete control over your development environment.

✨ New Features

Docker Sandbox Provider

• Fully Local Execution: Run Claude Code in isolated Docker containers
• Claude Agent SDK Integration: Correct async generator implementation for reliable code generation
• Multi-Directory File Detection: Automatically finds and exports generated files from /app and /tmp
• Specialized Agent Support: Works with all 160+ agents from the marketplace
• Automated Execution: --yes flag for CI/CD and scripting workflows
• Custom Environments: Bring your own Docker images

📦 What's Included

Core Files

• Dockerfile - Node.js 22 Alpine base image with development tools
• docker-launcher.js - Container lifecycle orchestration
• execute.js - Claude SDK execution with async generator support
• package.json - Runtime dependencies
• README.md - Complete documentation and troubleshooting guide

Web Documentation

• Docker provider section on component pages
• Provider comparison table (E2B vs Cloudflare vs Docker)
• Installation instructions and prerequisites
• Usage examples and best practices

🚀 Usage

Basic Usage

npx claude-code-templates@latest \
  --sandbox docker \
  --prompt "Write a REST API with Express" \
  --yes

With Specialized Agent

npx claude-code-templates@latest \
  --sandbox docker \
  --agent programming-languages/javascript-pro \
  --prompt "Create a function to add two numbers" \
  --yes

📋 Requirements

• Docker Desktop installed and running
• Anthropic API key configured
• Node.js 14+ (for CLI)

📊 Provider Comparison

🔧 Technical Improvements

• Correct SDK Usage: Implemented async generator iteration for query()
• Enhanced File Search: Scans multiple directories with find command
• Smart Prompts: Informs Claude about working directory context
• Flag Support: --yes flag now works correctly for sandbox execution
• Error Handling: Comprehensive error messages and troubleshooting

🐛 Bug Fixes

• Fixed async generator iteration in Claude Agent SDK
• Fixed --yes flag not skipping agent selection prompts
• Fixed file detection to include /tmp directory
• Removed misleading "works offline" messaging

📚 Documentation

• Component Page: https://aitmpl.com/component.html (Docker tab)
• README: cli-tool/components/sandbox/docker/README.md
• NPM: https://www.npmjs.com/package/claude-code-templates

🎯 Use Cases

• Local development without cloud dependencies
• Testing code in isolated environments
• Custom Docker environments with specific tools
• CI/CD integration with containerized testing
• Offline development (after initial setup)

📈 Stats

• Package Size: 375.9 kB
• Total Files: 92
• New Files: 5 (Docker sandbox components)
• Lines Changed: 1,671 insertions, 62 deletions

🔗 Links

• NPM Package: https://www.npmjs.com/package/claude-code-templates
• Documentation: https://aitmpl.com
• GitHub: https://github.com/davila7/claude-code-templates

💬 Feedback

Found a bug or have a feature request? Open an issue

Full Changelog: https://github.com/davila7/claude-code-templates/compare/v1.26.4...v1.27.0

🤖 Generated with Claude Code