{"id":29666508,"url":"https://github.com/glincker/commitweave","last_synced_at":"2026-04-12T09:37:36.090Z","repository":{"id":304927098,"uuid":"1020454719","full_name":"GLINCKER/commitweave","owner":"GLINCKER","description":"✨ A modern CLI tool to write smart, consistent, and beautiful git commit messages, powered by Conventional Commits, emoji support, and optional AI. @typeweaver/commitweave","archived":false,"fork":false,"pushed_at":"2025-07-16T04:17:34.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-17T07:20:49.431Z","etag":null,"topics":["ai-commit","automation","cli","commit-lint","commitizen","commits","conventional-commits","developer-tools","git","gitmoji","glincker","glinr","husky","ink","npx","openai","terminal","typeweaver"],"latest_commit_sha":null,"homepage":"https://typeweaver.com/","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/GLINCKER.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2025-07-15T22:39:38.000Z","updated_at":"2025-07-16T04:17:38.000Z","dependencies_parsed_at":"2025-07-17T12:00:08.590Z","dependency_job_id":"8ec87028-99c4-41e6-ba02-24af25953819","html_url":"https://github.com/GLINCKER/commitweave","commit_stats":null,"previous_names":["glincker/commitweave"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/GLINCKER/commitweave","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GLINCKER%2Fcommitweave","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GLINCKER%2Fcommitweave/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GLINCKER%2Fcommitweave/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GLINCKER%2Fcommitweave/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GLINCKER","download_url":"https://codeload.github.com/GLINCKER/commitweave/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GLINCKER%2Fcommitweave/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266516661,"owners_count":23941477,"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-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["ai-commit","automation","cli","commit-lint","commitizen","commits","conventional-commits","developer-tools","git","gitmoji","glincker","glinr","husky","ink","npx","openai","terminal","typeweaver"],"created_at":"2025-07-22T15:11:05.357Z","updated_at":"2026-04-12T09:37:36.084Z","avatar_url":"https://github.com/GLINCKER.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n\n# 🧶 CommitWeave\n\n**Create beautiful, standardized git commits with ease**\n\n[![npm version](https://badge.fury.io/js/@typeweaver%2Fcommitweave.svg)](https://www.npmjs.com/package/@typeweaver/commitweave)\n[![VS Code Extension](https://img.shields.io/badge/VS%20Code-Extension-blue?logo=visual-studio-code)](https://marketplace.visualstudio.com/items?itemName=glincker.commitweave)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue.svg)](https://www.typescriptlang.org/)\n\n*Developed by **GLINR STUDIOS***\n\n---\n\n**[🚀 Quick Start](#-quick-start)** • \n**[📖 Documentation](https://github.com/GLINCKER/commitweave/wiki)** • \n**[🎥 Demo](#-demo)** • \n**[🧩 VS Code Extension](#-vs-code-extension)** • \n**[🤖 AI Features](#-ai-powered-commits)**\n\n\u003c/div\u003e\n\n## ✨ What is CommitWeave?\n\nCommitWeave is a modern CLI tool and VS Code extension that transforms your git commit workflow. Create beautiful, consistent, and meaningful commit messages following conventional commit standards—with emoji support, AI assistance, and powerful automation.\n\n### 🎥 Demo\n\n\u003e *Add animated GIF showing CLI in action here*\n\u003e \n\u003e **Coming Soon**: Watch CommitWeave create perfect commits interactively with emoji selection, conventional commit formatting, and AI-powered suggestions.\n\n## 🚀 Quick Start\n\n### Step 1: Install\n```bash\n# CLI Tool\nnpm install -g @typeweaver/commitweave\n\n# VS Code Extension\n# Search \"CommitWeave\" in VS Code Extensions (Publisher: glincker)\n```\n\n### Step 2: Initialize\n```bash\n# Set up your project configuration\ncommitweave init\n```\n\n### Step 3: Create Beautiful Commits\n```bash\n# Interactive commit creation\ncommitweave\n\n# Or with AI assistance\ncommitweave --ai\n```\n\n**That's it!** 🎉 Start creating professional commits instantly.\n\n## 🧩 VS Code Extension\n\nOur VS Code extension brings CommitWeave directly into your editor with a rich, native experience.\n\n**Quick Access:**\n- **Command Palette**: `Ctrl+Shift+P` → \"CommitWeave\"\n- **Source Control Panel**: Click the \"⚡ Quick Commit\" button\n- **Status Bar**: Monitor your repo status at a glance\n\n**Features:**\n- 🎯 **5 Powerful Commands**: Create, AI Commit, Quick Commit, Validate, Configure  \n- ⚙️ **Enhanced Settings Panel**: Tabbed interface with visual configuration\n- 📊 **Commit History**: View and validate recent commits\n- 📝 **Smart Templates**: Pre-built commit templates with variables\n- ✅ **Real-time Validation**: Live commit message validation with suggestions\n\n## 🤖 AI-Powered Commits\n\nTransform your workflow with intelligent commit generation:\n\n- **🧠 Smart Analysis**: AI analyzes your staged changes\n- **⚡ Multiple Providers**: OpenAI GPT \u0026 Anthropic Claude support  \n- **🎨 Perfect Formatting**: Always follows conventional commit standards\n- **🔒 Secure**: Safe API key handling and local storage\n\n```bash\n# Generate AI commits from your changes\ncommitweave --ai\n```\n\n## 📋 Features Overview\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd valign=\"top\" width=\"50%\"\u003e\n\n### Core Features\n- 🎨 **Interactive CLI** with beautiful animations\n- 📝 **Conventional Commits** standard compliance  \n- 🎭 **Smart Emojis** for every commit type\n- ⚙️ **Highly Configurable** project settings\n- 🔧 **Git Integration** - stage and commit seamlessly\n- 📦 **TypeScript First** with full IntelliSense\n- 🛡️ **Cross-Platform** (Windows, macOS, Linux)\n- ⚡ **Command Shortcuts** for power users\n\n\u003c/td\u003e\n\u003ctd valign=\"top\" width=\"50%\"\u003e\n\n### Advanced Features\n- 🤖 **AI Commit Generation** (OpenAI \u0026 Claude)\n- 🧩 **VS Code Extension** with native integration\n- 📋 **Team Config Sharing** via export/import\n- ✅ **Message Validation** with actionable solutions\n- 📊 **Diff Analysis** with smart statistics\n- 🎯 **Progress Indicators** for all operations\n- 🔄 **Version Control** for configurations\n- 🏥 **Health Monitoring** with doctor command\n- 🎨 **UI Configuration** - customize all visual elements\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 📚 Commands Reference\n\n### Essential Commands\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `commitweave` | Interactive commit creation | Creates commits with guided prompts |\n| `commitweave ai` | AI-powered commit generation | Analyzes changes, suggests commits |\n| `commitweave init` | Initialize project configuration | Sets up `glinr-commit.json` |\n| `commitweave check` | Validate your last commit | Checks conventional commit compliance |\n\n### ⚡ Command Shortcuts (Power Users)\n\n| Shortcut | Full Command | Description |\n|----------|-------------|-------------|\n| `commitweave v` | `commitweave check` | Quick validate last commit |\n| `commitweave ls` | `commitweave list` | Quick list configuration |  \n| `commitweave ai` | `commitweave --ai` | Direct AI commit (no flag) |\n| `commitweave health` | `commitweave doctor` | Quick health check |\n\n### Configuration Management\n\n| Command | Description | Use Case |\n|---------|-------------|----------|\n| `commitweave export` | Export current config | Share team settings |\n| `commitweave import \u003cfile\u003e` | Import shared config | Adopt team standards |\n| `commitweave list` | View current settings | Check your configuration |\n| `commitweave doctor` | Diagnose config issues | Troubleshoot problems |\n| `commitweave reset` | Reset to defaults | Start fresh |\n\n### VS Code Commands\n\n| Command | Description | Access |\n|---------|-------------|--------|\n| **CommitWeave: Create Commit** | Launch interactive CLI | Command Palette |\n| **CommitWeave: AI Commit** | Generate AI commit messages | Command Palette |\n| **CommitWeave: Quick Commit** | Fast conventional commits | Command Palette / SCM Panel |\n| **CommitWeave: Validate Commit** | Check last commit | Command Palette |\n| **CommitWeave: Configure** | Open settings panel | Command Palette |\n\n## ⚙️ Configuration\n\n### Default Commit Types\n\n| Type | Emoji | Description |\n|------|-------|-------------|\n| `feat` | ✨ | New features |\n| `fix` | 🐛 | Bug fixes |  \n| `docs` | 📚 | Documentation |\n| `style` | 💎 | Code formatting |\n| `refactor` | 📦 | Code refactoring |\n| `perf` | 🚀 | Performance improvements |\n| `test` | 🚨 | Testing |\n| `build` | 🛠 | Build system |\n| `ci` | ⚙️ | CI/CD |\n| `chore` | ♻️ | Maintenance |\n| `revert` | 🗑 | Reverts |\n\n### Sample Configuration\n```json\n{\n  \"version\": \"1.0\",\n  \"emojiEnabled\": true,\n  \"conventionalCommits\": true,\n  \"maxSubjectLength\": 50,\n  \"ai\": {\n    \"provider\": \"openai\",\n    \"model\": \"gpt-4\"\n  },\n  \"ui\": {\n    \"fancyUI\": true,\n    \"asciiArt\": true,\n    \"animations\": true,\n    \"colors\": true,\n    \"emoji\": true\n  }\n}\n```\n\n## 🛠️ Development\n\n### Prerequisites\n- Node.js ≥ 18.0.0\n- npm or yarn\n- Git\n\n### Setup\n```bash\ngit clone https://github.com/GLINCKER/commitweave.git\ncd commitweave\nnpm install\nnpm run build\nnpm test\n```\n\n## 🧪 Testing \u0026 Quality Assurance\n\nCommitWeave maintains exceptional quality through comprehensive testing across multiple dimensions:\n\n### ✅ Test Coverage Summary\n- **Platform Compatibility**: 6/6 tests passed (100% success rate)\n- **AI Functionality**: 6/6 AI tests passed with fallback validation  \n- **Performance**: 24ms startup time (12x better than 300ms target)\n- **VS Code Integration**: All extension commands validated\n- **Fallback Behavior**: 5/5 network failure scenarios handled gracefully\n\n### 🖥️ Platform Compatibility\n- **Operating Systems**: macOS, Linux, Windows\n- **Shells**: zsh, bash, PowerShell, Command Prompt\n- **Terminals**: Terminal.app, iTerm2, Windows Terminal, VS Code integrated terminal\n- **Full emoji and ANSI color support** verified across platforms\n\n### 🤖 AI Provider Testing\n- **OpenAI GPT**: Full integration with API key validation\n- **Anthropic Claude**: Complete Claude 3 model support\n- **Mock AI Provider**: Always available as ultimate fallback\n- **Network Failure Handling**: Graceful degradation with user warnings\n- **Invalid API Key Detection**: Automatic fallback to Mock AI\n\n### ⚡ Performance Benchmarks\n```bash\n# Run performance benchmarks\nnpm run bench\n\n# Results: ~24ms cold-start (target: ≤300ms)\n# 13x performance improvement achieved\n```\n\n### 🧪 Running Tests\n```bash\n# Cross-platform compatibility testing\nnpx tsx scripts/test-cross-platform.ts\n\n# AI functionality and fallback testing  \nnpx tsx scripts/test-ai-functionality.ts\nnpx tsx scripts/test-ai-fallback.ts\n\n# VS Code extension integration testing\nnpx tsx scripts/test-vscode-integration.ts\n\n# Performance benchmarking\nnpm run bench\n```\n\n### 📊 Testing Reports\n- **Platform Results**: [docs/platform-compatibility.md](docs/platform-compatibility.md)\n- **Test Artifacts**: `docs/testing-reports/` directory\n- **File Structure**: [docs/file-map.md](docs/file-map.md)\n\n## 🤝 Contributing\n\nWe welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) for:\n\n- 🔧 Local development setup\n- 🧪 Testing instructions  \n- 📝 How to add commit types\n- 🤖 Adding AI providers\n- 📋 Code style guidelines\n\n## 📖 Documentation \u0026 Resources\n\n- **[📚 Full Documentation](https://github.com/GLINCKER/commitweave/wiki)** - Complete guides and tutorials\n- **[🐛 Report Issues](https://github.com/GLINCKER/commitweave/issues)** - Bug reports and feature requests  \n- **[💬 Discussions](https://github.com/GLINCKER/commitweave/discussions)** - Community support and ideas\n- **[🚀 Releases](https://github.com/GLINCKER/commitweave/releases)** - Latest versions and changelog\n- **[📦 NPM Package](https://www.npmjs.com/package/@typeweaver/commitweave)** - Package details and stats\n\n## 🔗 Beta Signup \u0026 Early Access\n\n**[📝 Join the Beta Program](https://forms.gle/YOUR-BETA-SIGNUP-LINK)**\n\nGet early access to new features:\n- 🚀 Latest features before general release\n- 💬 Direct feedback channel with our team\n- 🎁 Exclusive beta-only features and themes\n- 📧 Priority support and feature requests\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by [GLINR STUDIOS](https://github.com/GLINCKER)**\n\n**[⭐ Star us on GitHub](https://github.com/GLINCKER/commitweave)** • **[🐦 Follow @TypeWeaver](https://twitter.com/typeweaver)** • **[💬 Join our Discord](https://discord.gg/typeweaver)**\n\n\u003c/div\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglincker%2Fcommitweave","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglincker%2Fcommitweave","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglincker%2Fcommitweave/lists"}