{"id":37324811,"url":"https://github.com/aicgen/aicgen","last_synced_at":"2026-01-16T03:27:24.961Z","repository":{"id":328158952,"uuid":"1110012611","full_name":"aicgen/aicgen","owner":"aicgen","description":"AI Config Generator","archived":false,"fork":false,"pushed_at":"2026-01-01T09:51:57.000Z","size":1097,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T13:55:28.217Z","etag":null,"topics":["ai","ai-agents","antigravity","best-practices","claude-code","codex","prompt-engineering"],"latest_commit_sha":null,"homepage":"https://aicgen.github.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aicgen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-04T15:37:58.000Z","updated_at":"2026-01-01T09:52:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/aicgen/aicgen","commit_stats":null,"previous_names":["lpsandaruwan/aicgen","aicgen/aicgen"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/aicgen/aicgen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicgen%2Faicgen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicgen%2Faicgen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicgen%2Faicgen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicgen%2Faicgen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aicgen","download_url":"https://codeload.github.com/aicgen/aicgen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicgen%2Faicgen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28477203,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T03:13:13.607Z","status":"ssl_error","status_checked_at":"2026-01-16T03:11:47.863Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai","ai-agents","antigravity","best-practices","claude-code","codex","prompt-engineering"],"created_at":"2026-01-16T03:27:24.836Z","updated_at":"2026-01-16T03:27:24.938Z","avatar_url":"https://github.com/aicgen.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.svg\" width=\"1000\" alt=\"aicgen logo\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eConfiguration generator for AI coding assistants\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-1.0--beta-cyan\" alt=\"Version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-purple\" alt=\"License\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/bun-%3E%3D1.0.0-cyan\" alt=\"Bun\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/aicgen/aicgen/test.yml?branch=main\u0026label=tests\" alt=\"Tests\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/coverage-94%25-brightgreen\" alt=\"Coverage\" /\u003e\n\u003c/p\u003e\n\n---\n\n**aicgen** makes your project AI-ready in seconds. Generate tailored instruction files for your AI coding assistant with an interactive CLI wizard.\n\n## ✨ Features\n\n- **🎯 Multi-Assistant Support** - Claude Code, GitHub Copilot, Gemini, Antigravity, Codex\n- **📚 82+ Guidelines** - Organized into 12 categories (Language, Architecture, Testing, Security, etc.)\n- **🎨 Interactive CLI** - Professional wizard with smart defaults and back navigation\n- **⚡ Hooks \u0026 Sub-Agents** - Auto-generates Claude Code hooks and verification agents\n- **🏗️ Architecture Aware** - Supports Microservices, Modular Monoliths, Hexagonal, and more\n- **📦 Zero External Dependencies** - All guideline data is embedded in the binary\n\n## 🚀 Quick Start\n\nNavigate to your project and run:\n\n```bash\naicgen init\n```\n\nThe CLI will:\n1.  Detect your project language and structure\n2.  Guide you through assistant, architecture, and detail level selection\n3.  Let you customize which guidelines to include\n4.  Generate the appropriate config files (`.claude/`, `.github/`, `.agent/`, etc.)\n\n---\n\n## 📦 Installation\n\n### From npm (Easiest)\n\n```bash\n# Install globally\nnpm install -g @aicgen/aicgen\n\n# Or use with npx (no installation)\nnpx @aicgen/aicgen init\n```\n\n### From Homebrew (macOS)\n\n```bash\n# Add the tap\nbrew tap aicgen/aicgen\n\n# Install aicgen\nbrew install aicgen\n```\n\n### From Binary (Standalone)\n\nDownload the latest installer for your platform from the [releases page](https://github.com/aicgen/aicgen/releases):\n\n- **Windows**: `aicgen-setup-x64.exe` installer\n- **Linux (Debian/Ubuntu)**: `aicgen_amd64.deb`\n- **Linux (Fedora/RHEL)**: `aicgen_x86_64.rpm`\n\n```bash\n# Windows - run the installer\naicgen-setup-x64.exe\n\n# Linux (Debian/Ubuntu)\nsudo dpkg -i aicgen_amd64.deb\n\n# Linux (Fedora/RHEL)\nsudo rpm -i aicgen_x86_64.rpm\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/aicgen/aicgen.git\ncd aicgen\nbun install\nbun run build:binary\nbun run start init\n```\n\n---\n\n## 📚 Guideline System\n\naicgen uses a **modular guideline architecture** with **82+ guidelines** organized into **12 categories**.\n\n```bash\n# View guideline statistics\naicgen stats\n```\n\n**Categories:**\n- **Language** - TypeScript, Python, Go, Rust, Java, C#, Ruby, JavaScript\n- **Architecture** - Layered, Modular Monolith, Microservices, Event-Driven, Hexagonal\n- **DevOps** - CI/CD, Docker, Observability (Log formats, Metrics)\n- **Best Practices** - SOLID, DRY, Clean Code principles\n- And more...\n\n## 📁 Generated Outputs\n\n### For Claude Code\n```text\nCLAUDE.md                      # Master instructions (project root)\n.claude/\n├── settings.json              # Hooks \u0026 permissions\n├── guidelines/                # Modular guidelines\n│   ├── language.md\n│   ├── architecture.md\n│   └── ...\n└── agents/                    # Sub-agents\n    └── guideline-checker.md\n```\n\n### For GitHub Copilot\n```text\n.github/\n├── copilot-instructions.md    # Master instructions\n└── instructions/              # Topic-specific files\n```\n\n### For Gemini / Antigravity\n```text\n.gemini/                       # or .agent/\n└── instructions.md            # Consolidated system prompt\n```\n\n---\n\n## 🗺️ Roadmap\n\n### ✅ Completed\n\n- [x] Interactive CLI wizard with back navigation\n- [x] Multi-assistant support (Claude Code, Copilot, Gemini, Antigravity, Codex)\n- [x] 82+ guidelines across 12 categories\n- [x] Architecture-aware configuration (Layered, Modular Monolith, Microservices, etc.)\n- [x] Auto-generated hooks and sub-agents for Claude Code\n- [x] Custom guideline management (add/remove)\n- [x] GitHub-based guideline updates\n\n### 🚧 Future Enhancements\n\n- [ ] Custom validation hooks\n- [ ] Guideline versioning and diffing\n- [ ] Project-specific guideline templates\n\n## 🛠️ Development\n\n### Running Tests\n\nThe project includes a comprehensive test suite with 60+ tests covering all core functionality:\n\n```bash\n# Run all tests\nbun test\n\n# Run tests with coverage report\nbun test --coverage\n\n# Run tests in watch mode\nbun test --watch\n```\n\n### Test Coverage\n\nCurrent test coverage: **94%** (93.44% function coverage, 94.52% line coverage)\n\n**Test Suite Includes:**\n- ✅ GuidelineLoader tests (filtering, level selection, architecture handling)\n- ✅ Tarball extraction tests (CONFIG-based prefix validation)\n- ✅ AssistantFileWriter tests (all 5 assistants - Claude Code, Copilot, Gemini, Antigravity, Codex)\n- ✅ File generation and path handling (cross-platform compatibility)\n- ✅ Content validation and metadata inclusion\n\nTests are automatically excluded from builds via `tsconfig.json`.\n\n### Project Structure\n\n```\nsrc/\n├── __tests__/              # Test suite\n│   └── services/\n│       ├── guideline-loader.test.ts\n│       ├── tarball-extraction.test.ts\n│       └── assistant-file-writer.test.ts\n├── commands/               # CLI commands (init, update, quick-add)\n├── services/               # Core business logic\n└── config.ts              # Configuration management\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## 📄 License\n\nMIT © 2025\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faicgen%2Faicgen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faicgen%2Faicgen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faicgen%2Faicgen/lists"}