{"id":30084435,"url":"https://github.com/dkmaker/claude-jsqualityhooks","last_synced_at":"2025-08-08T23:30:21.159Z","repository":{"id":308870107,"uuid":"1033739620","full_name":"dkmaker/claude-jsqualityhooks","owner":"dkmaker","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-08T11:47:16.000Z","size":264,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-08T12:19:35.710Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dkmaker.png","metadata":{"files":{"readme":"docs/README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-07T09:17:37.000Z","updated_at":"2025-08-08T11:47:20.000Z","dependencies_parsed_at":"2025-08-08T12:19:37.509Z","dependency_job_id":"8d0b3abd-9193-4aa5-a3c0-ee0bded767ae","html_url":"https://github.com/dkmaker/claude-jsqualityhooks","commit_stats":null,"previous_names":["dkmaker/claude-jsqualityhooks"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/dkmaker/claude-jsqualityhooks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkmaker%2Fclaude-jsqualityhooks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkmaker%2Fclaude-jsqualityhooks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkmaker%2Fclaude-jsqualityhooks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkmaker%2Fclaude-jsqualityhooks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dkmaker","download_url":"https://codeload.github.com/dkmaker/claude-jsqualityhooks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkmaker%2Fclaude-jsqualityhooks/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269505019,"owners_count":24428346,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-08T02:00:09.200Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-08T23:30:16.329Z","updated_at":"2025-08-08T23:30:20.993Z","avatar_url":"https://github.com/dkmaker.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude JS Quality Hooks\n\nA TypeScript-based Claude Code Hooks extension that ensures code quality through automatic validation and fixing.\n\n**Repository**: https://github.com/dkmaker/claude-jsqualityhooks  \n**Developer**: DKMaker  \n**NPM Package**: `claude-jsqualityhooks`\n\n## Overview\n\nThis project provides post-write hooks for Claude Code that:\n- Validate code immediately after Claude writes files\n- Automatically fix formatting and linting issues\n- Support multiple Biome versions with auto-detection\n- Provide AI-optimized output for clear error reporting\n- Maintain context synchronization with Claude\n\n## Quick Start\n\n**No installation required!** Use directly with `npx`:\n\n1. **Initialize Configuration**\n   ```bash\n   npx claude-jsqualityhooks init\n   ```\n   This creates `claude-jsqualityhooks.config.yaml` and detects your environment.\n\n2. **Install Biome in your project**\n   ```bash\n   npm install --save-dev @biomejs/biome  # Automatically detects version\n   ```\n\n3. **Register with Claude**\n   ```bash\n   npx claude-jsqualityhooks install\n   ```\n\nThat's it! The hooks will now run automatically when Claude modifies files.\n\n### Optional: Global Installation\n\nFor frequent CLI usage, you can install globally:\n```bash\n# Always use npx - no installation needed\nnpx claude-jsqualityhooks [command]\nclaude-jsqualityhooks version  # Now available without npx\n```\n\nSee [Installation Guide](./INSTALLATION.md) for detailed setup options.\n\n## Key Features\n\n- ✅ **Automatic Validation** - TypeScript type checking and Biome linting\n- ✅ **Auto-Fix** - Automatically fixes formatting and safe linting issues\n- ✅ **Version Detection** - Works with multiple Biome versions\n- ✅ **AI-Optimized Output** - Clean, structured output for Claude\n- ✅ **Performance** - Parallel processing and intelligent caching\n\n## Project Goals\n\n1. **Automatic Code Quality** - Validate and fix files immediately after Claude writes them\n2. **Seamless Remediation** - Fix issues automatically without manual intervention\n3. **Transparent Communication** - Keep Claude informed of all modifications\n4. **Comprehensive Coverage** - Support multiple file types through unified interface\n5. **Performance** - Minimal latency while ensuring thorough validation\n\n## Documentation Structure\n\n- **[Architecture](./ARCHITECTURE.md)** - System design and components\n- **[Development](./DEVELOPMENT.md)** - Implementation phases and workflow\n- **Features**\n  - [Hook System](./features/01-hook-system.md)\n  - [Biome Validator](./features/02-biome-validator.md)\n  - [TypeScript Validator](./features/03-typescript-validator.md)\n  - [AI Formatter](./features/04-ai-formatter.md)\n  - [Auto-Fix Engine](./features/05-auto-fix-engine.md)\n- **Configuration**\n  - [Configuration Guide](./config/configuration-guide.md)\n  - [Example Config](./config/example-config.yaml)\n- **API Reference**\n  - [Interfaces](./api/interfaces.md)\n  - [Hook API](./api/hook-api.md)\n  - [Formatter API](./api/formatter-api.md)\n- **Implementation Guides**\n  - [Phase 1: Infrastructure](./implementation/phase-1-infrastructure.md)\n  - [Phase 2: Validators](./implementation/phase-2-validators.md)\n  - [Phase 3: Auto-Fix](./implementation/phase-3-auto-fix.md)\n  - [Phase 4: AI Output](./implementation/phase-4-ai-output.md)\n  - [Phase 5: Testing](./implementation/phase-5-testing.md)\n\n## Supported File Types\n\n### Primary Support\n- TypeScript (.ts, .tsx)\n- JavaScript (.js, .jsx, .mjs, .cjs)\n- JSON (.json, .jsonc)\n\n### Extended Support\n- CSS/SCSS (.css, .scss, .sass)\n- HTML (.html, .htm)\n- Markdown (.md, .mdx)\n- YAML (.yml, .yaml)\n\n## Requirements\n\n- Node.js 18+\n- Claude Code CLI\n- TypeScript 5.x\n- Biome (current versions)\n\n## License\n\nMIT - See LICENSE file for details\n\n## Repository\n\n**GitHub**: https://github.com/dkmaker/claude-jsqualityhooks  \n**Developer**: DKMaker","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkmaker%2Fclaude-jsqualityhooks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdkmaker%2Fclaude-jsqualityhooks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkmaker%2Fclaude-jsqualityhooks/lists"}