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-marketplace

Run it inside Claude Code after adding the marketplace with /plugin marketplace add atournayre/claude-marketplace.

Contents

Discovered from source

Agents 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

More from atournayre/claude-marketplace

All 18