Project Profiles & Presets: `hx preset`

[ashigirl96]

Summary

Curated bundles of extensions + configuration that can be applied in one command to set up an opinionated Claude Code environment.

Motivation

Different projects and teams need different hook configurations. A security-focused project needs secret guards and command restrictions. A code review workflow needs linting hooks and context injection. Setting these up manually for each repo is tedious and error-prone.

Proposed CLI

hx preset security     # apply security-hardening extensions
hx preset review       # apply code review workflow
hx preset onboarding   # apply guardrails for new team members
hx preset list         # show available presets

Key Features

• Built-in presets: security, review, onboarding ship with hx
• Custom presets: Define in hx.config.ts or as standalone packages
• Declarative project config: hx.config.ts at repo root declares which presets/extensions to use
• Composable: Presets can extend other presets
• Team sharing: Commit hx.config.ts to the repo for consistent team-wide setup

Example Config

// hx.config.ts
export default {
  presets: ["security"],
  extensions: {
    "guard-secrets": { patterns: [/AWS_SECRET/] },
    "rate-limiter": { maxBashPerMinute: 10 },
  },
}