
customize
Personnalise ton expérience Claude Code avec hooks, output styles, status lines sur mesure + Bash Security Validator
- GitHub stars
- 9
Install
/plugin install customize@atournayre-claude-plugin-marketplaceRun it inside Claude Code after adding the marketplace with /plugin marketplace add atournayre/claude-marketplace.
Contents
Discovered from sourceAgents 3
[1.1.1] - 2026-02-04
Changed
- Migrer noms de modèles Claude vers format court (sonnet, haiku, opus)
Changelog
Toutes les modifications notables de ce projet seront documentées dans ce fichier.
Le format est basé sur Keep a Changelog, et ce projet adhère au Versioning Sémantique.
[1.1.0] - 2026-01-31
Added
- Bash Security Validator : Validateur de sécurité pour commandes bash (TypeScript/Bun)
- 100+ patterns de sécurité (commandes critiques, escalade privilèges, attaques réseau)
- 82+ tests automatisés avec Bun test
- Détection patterns malveillants (fork bombs, backdoors, exfiltration données)
- Protection chemins système (/etc, /usr, /bin, /sys, /proc, /dev, /root)
- Logs sécurité avec traçabilité complète (data/security.log)
- Hook PreToolUse configuré automatiquement
- Architecture hybride Python + TypeScript
- Hooks Python pour événements Claude Code
- Validators TypeScript/Bun pour validation haute performance
- Documentation complète validators/bash/README.md
Changed
- README.md : Section Bash Security Validator + Architecture Hybride
- Structure du plugin : Ajout dossier validators/
Migration
- Migré depuis plugin mlvn (AIBlueprint v1.0.0)
- Conservation de tous les tests et règles de sécurité
- Logs sécurité gitignorés pour éviter commit données sensibles
[1.0.0] - 2025-11-15
Added
- Plugin vide pour personnalisations utilisateur
- Structure de base pour commandes et skills custom
Plugin Customize
Personnalise ton expérience Claude Code avec hooks, output styles et status lines sur mesure.
Installation
/plugin install customize@atournayre
Fonctionnalités
Hooks Personnalisés
Scripts Python pour automatiser et personnaliser le comportement de Claude Code à différents moments du cycle de vie.
Hooks Disponibles
notification.py
- Gestion des notifications système
- Alertes visuelles/sonores pour événements importants
session_start.py
- Exécuté au démarrage de session
- Configuration initiale
- Chargement de contexte
user_prompt_submit.py
- Exécuté avant traitement du prompt utilisateur
- Validation
- Transformation du prompt
pre_tool_use.py
- Exécuté avant chaque utilisation d'outil
- Validation des paramètres
- Logging
- Sécurité
post_tool_use.py
- Exécuté après chaque utilisation d'outil
- Analyse des résultats
- Cleanup
- Métriques
pre_compact.py
- Exécuté avant compaction du contexte
- Sauvegarde de données importantes
- Archivage
stop.py
- Exécuté à l'arrêt de session
- Cleanup final
- Sauvegarde d'état
subagent_stop.py
- Exécuté à l'arrêt d'un sous-agent
- Récupération de résultats
- Cleanup spécifique
Bash Security Validator ⚡
Validateur de sécurité pour commandes bash (TypeScript/Bun)
Protection automatique contre commandes dangereuses via hook PreToolUse :
- ✅ 100+ patterns de sécurité : Bloque rm -rf /, dd, mkfs, etc.
- ✅ 82+ tests automatisés : Suite complète de validation
- ✅ Détection patterns malveillants : Fork bombs, backdoors, exfiltration
- ✅ Protection chemins système : Empêche écritures dans /etc, /usr, /bin
- ✅ Logs sécurité : Traçabilité complète des blocages
Commandes bloquées :
- Destruction système :
rm -rf /,dd if=/dev/zero,mkfs - Escalade privilèges :
sudo,chmod 777,passwd - Attaques réseau :
nc -l,nmap,telnet - Patterns malveillants : Fork bombs, backdoors, manipulation logs
Documentation complète : validators/bash/README.md
Configuration
Les hooks sont automatiquement détectés et chargés depuis customize/hooks/.
Pour activer un hook dans ton projet :
{
"hooks": {
"session_start": "path/to/customize/hooks/session_start.py",
"user_prompt_submit": "path/to/customize/hooks/user_prompt_submit.py",
"pre_tool_use": "path/to/customize/hooks/pre_tool_use.py",
"post_tool_use": "path/to/customize/hooks/post_tool_use.py",
"notification": "path/to/customize/hooks/notification.py",
"pre_compact": "path/to/customize/hooks/pre_compact.py",
"stop": "path/to/customize/hooks/stop.py",
"subagent_stop": "path/to/customize/hooks/subagent_stop.py"
}
}
Cas d'Usage
Workflow automatisé :
- Charger contexte projet au démarrage
- Valider commandes avant exécution
- Logger toutes les actions
- Archiver historique à l'arrêt
Sécurité :
- Bloquer outils dangereux
- Valider chemins de fichiers
- Auditer les accès
Métriques :
- Tracker temps d'exécution
- Compter utilisations d'outils
- Analyser patterns
Notifications :
- Alertes pour tâches longues
- Notifications de fin de traitement
- Erreurs critiques
Structure
customize/
├── .claude-plugin/
│ ├── plugin.json
│ └── hooks.json # Configuration hook PreToolUse (Bash Validator)
├── hooks/ # Hooks Python
│ ├── notification.py
│ ├── session_start.py
│ ├── user_prompt_submit.py
│ ├── pre_tool_use.py
│ ├── post_tool_use.py
│ ├── pre_compact.py
│ ├── stop.py
│ ├── subagent_stop.py
│ └── utils/
└── validators/ # Validators TypeScript/Bun
└── bash/ # Bash Security Validator
├── src/
│ ├── cli.ts # Entry point hook PreToolUse
│ └── lib/
│ ├── security-rules.ts # 100+ patterns sécurité
│ ├── validator.ts
│ └── types.ts
├── __tests__/ # 82+ tests
├── package.json
└── README.md
Architecture Hybride
Ce plugin utilise une architecture hybride Python + TypeScript :
- Hooks Python (
hooks/) : Gestion événements Claude Code (session, prompts, notifications) - Validators TypeScript (
validators/) : Validation sécurité haute performance avec Bun
Pourquoi hybride ?
- Python : Excellent pour scripts hooks, intégration système, flexibilité
- TypeScript/Bun : Performance critique pour validation temps réel, tests robustes (82+)
Dépendances :
- Python 3.x (hooks)
- Bun runtime (validators, optionnel si validators non utilisés)
Développement de Hooks
Template de Base
#!/usr/bin/env python3
"""
Hook description
"""
def main():
"""Hook entry point"""
# Your logic here
pass
if __name__ == "__main__":
main()
Best Practices
- Hooks légers et rapides
- Gestion d'erreurs robuste
- Logging approprié
- Pas d'effets de bord inattendus
- Documentation claire
Licence
MIT
Bash Command Validator
Validateur de sécurité pour les commandes bash dans Claude Code. Intégré via le hook PreToolUse pour bloquer les opérations dangereuses avant exécution.
Fonctionnalités
- 100+ règles de sécurité : Bloque commandes dangereuses (rm -rf /, dd, mkfs, etc.)
- Détection de patterns malveillants : Fork bombs, backdoors, exfiltration de données
- Protection des chemins système : Empêche écritures dans /etc, /usr, /bin, etc.
- Validation des chaînes de commandes : Analyse &&, ||, ;
- 82+ tests : Suite de tests complète avec Vitest
Installation
cd customize/validators/bash
bun install
Utilisation
En tant que hook Claude Code
Configuration dans .claude-plugin/hooks.json :
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "bun ${CLAUDE_PLUGIN_ROOT}/validators/bash/src/cli.ts"
}
]
}
]
}
}
Utilisation programmatique
import { CommandValidator } from "./src/lib/validator";
const validator = new CommandValidator();
const result = validator.validate("rm -rf /");
if (!result.isValid) {
console.log(`Bloqué: ${result.violations.join(", ")}`);
console.log(`Sévérité: ${result.severity}`);
}
Tests
# Lancer tous les tests (82+)
bun test
# Tests avec interface UI
bun test:ui
# Linting
bun run lint
# Vérification types
bun run typecheck
Couverture des Tests
Commandes Sûres (Autorisées)
- Utilitaires standard : ls, git, npm, pnpm, node, python
- Opérations fichiers : cat, cp, mv, mkdir, touch
- Chaînes de commandes safe avec &&
Commandes Dangereuses (Bloquées)
- Destruction système : rm -rf /, dd, mkfs, fdisk
- Escalade privilèges : sudo, chmod, chown, passwd
- Attaques réseau : nc, nmap, telnet
- Patterns malveillants : fork bombs, backdoors, manipulation logs
- Accès fichiers sensibles : /etc/passwd, /etc/shadow, /etc/sudoers
Cas Spéciaux
- rm -rf sécurisé : Autorise suppressions dans chemins safe (~/Developer/, /tmp/)
- Chemins protégés : Bloque opérations dangereuses sur /etc, /usr, /bin, etc.
- Détection contenu binaire
- Limites longueur commandes
Architecture
src/
├── cli.ts # Point d'entrée CLI (utilisé par hook Claude Code)
├── lib/
│ ├── types.ts # Interfaces TypeScript
│ ├── security-rules.ts # Base de données règles sécurité (100+ patterns)
│ └── validator.ts # Logique validation principale
__tests__/
└── validator.test.ts # Suite tests complète (82+ tests)
Règles de Sécurité
Commandes Critiques
del, format, mkfs, shred, dd, fdisk, parted
Escalade de Privilèges
sudo, su, passwd, chpasswd, usermod, chmod, chown
Commandes Réseau
nc, netcat, nmap, telnet, ssh-keygen, iptables
Manipulation Système
systemctl, service, kill, killall, mount, umount
Chemins Protégés
/etc/, /usr/, /sbin/, /boot/, /sys/, /proc/, /dev/, /root/
Logs de Sécurité
Événements sécurité loggés dans data/security.log :
- Timestamp
- Session ID
- Nom outil
- Commande (tronquée à 500 chars)
- Statut bloqué/autorisé
- Niveau sévérité
- Violations détectées
Le dossier data/ est gitignored pour éviter commit données sensibles.
Développement
# Linter
bun run lint
# Formater code
bun run format
# Type check
bun run typecheck
Licence
MIT
Sponsors
Details
- Marketplace
- atournayre/claude-marketplace
- Source
- customize
- Category
- Community