✨ What is CommitWeave?

CommitWeave 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.

$3

> Add animated GIF showing CLI in action here
>
> Coming Soon: Watch CommitWeave create perfect commits interactively with emoji selection, conventional commit formatting, and AI-powered suggestions.

🚀 Quick Start

$3

``bash

CLI Tool

npm install -g @typeweaver/commitweave

VS Code Extension

Search "CommitWeave" in VS Code Extensions (Publisher: glincker)

`

$3

`bash

Set up your project configuration

commitweave init
`

$3

`bash

Interactive commit creation

commitweave

Or with AI assistance

commitweave --ai
`

That's it! 🎉 Start creating professional commits instantly.

🧩 VS Code Extension

Our VS Code extension brings CommitWeave directly into your editor with a rich, native experience.

Quick Access:
- Command Palette: Ctrl+Shift+P → "CommitWeave"
- Source Control Panel: Click the "⚡ Quick Commit" button
- Status Bar: Monitor your repo status at a glance

Features:
- 🎯 5 Powerful Commands: Create, AI Commit, Quick Commit, Validate, Configure
- ⚙️ Enhanced Settings Panel: Tabbed interface with visual configuration
- 📊 Commit History: View and validate recent commits
- 📝 Smart Templates: Pre-built commit templates with variables
- ✅ Real-time Validation: Live commit message validation with suggestions

🤖 AI-Powered Commits

Transform your workflow with intelligent commit generation:

- 🧠 Smart Analysis: AI analyzes your staged changes
- ⚡ Multiple Providers: OpenAI GPT & Anthropic Claude support
- 🎨 Perfect Formatting: Always follows conventional commit standards
- 🔒 Secure: Safe API key handling and local storage

`bash


Generate AI commits from your changes


commitweave --ai
`

📋 Features Overview

$3 - 🎨 Interactive CLI with beautiful animations - 📝 Conventional Commits standard compliance - 🎭 Smart Emojis for every commit type - ⚙️ Highly Configurable project settings - 🔧 Git Integration - stage and commit seamlessly - 📦 TypeScript First with full IntelliSense - 🛡️ Cross-Platform (Windows, macOS, Linux) - ⚡ Command Shortcuts for power users

$3 - 🤖 AI Commit Generation (OpenAI & Claude) - 🧩 VS Code Extension with native integration - 📋 Team Config Sharing via export/import - ✅ Message Validation with actionable solutions - 📊 Diff Analysis with smart statistics - 🎯 Progress Indicators for all operations - 🔄 Version Control for configurations - 🏥 Health Monitoring with doctor command - 🎨 UI Configuration - customize all visual elements

📚 Commands Reference

$3

| Command | Description | Example |
|---------|-------------|---------|
| commitweave | Interactive commit creation | Creates commits with guided prompts |
| commitweave ai | AI-powered commit generation | Analyzes changes, suggests commits |
| commitweave init | Initialize project configuration | Sets up glinr-commit.json |
| commitweave check | Validate your last commit | Checks conventional commit compliance |

$3

| Shortcut | Full Command | Description |
|----------|-------------|-------------|
| commitweave v | commitweave check | Quick validate last commit |
| commitweave ls | commitweave list | Quick list configuration |
| commitweave ai | commitweave --ai | Direct AI commit (no flag) |
| commitweave health | commitweave doctor | Quick health check |

$3

| Command | Description | Use Case |
|---------|-------------|----------|
| commitweave export | Export current config | Share team settings |
| commitweave import | Import shared config | Adopt team standards |
| commitweave list | View current settings | Check your configuration |
| commitweave doctor | Diagnose config issues | Troubleshoot problems |
| commitweave reset | Reset to defaults | Start fresh |

$3

| Command | Description | Access |
|---------|-------------|--------|
| CommitWeave: Create Commit | Launch interactive CLI | Command Palette |
| CommitWeave: AI Commit | Generate AI commit messages | Command Palette |
| CommitWeave: Quick Commit | Fast conventional commits | Command Palette / SCM Panel |
| CommitWeave: Validate Commit | Check last commit | Command Palette |
| CommitWeave: Configure | Open settings panel | Command Palette |

⚙️ Configuration

$3

| Type | Emoji | Description |
|------|-------|-------------|
| feat | ✨ | New features |
| fix | 🐛 | Bug fixes |
| docs | 📚 | Documentation |
| style | 💎 | Code formatting |
| refactor | 📦 | Code refactoring |
| perf | 🚀 | Performance improvements |
| test | 🚨 | Testing |
| build | 🛠 | Build system |
| ci | ⚙️ | CI/CD |
| chore | ♻️ | Maintenance |
| revert | 🗑 | Reverts |

$3


`json
{
"version": "1.0",
"emojiEnabled": true,
"conventionalCommits": true,
"maxSubjectLength": 50,
"ai": {
"provider": "openai",
"model": "gpt-4"
},
"ui": {
"fancyUI": true,
"asciiArt": true,
"animations": true,
"colors": true,
"emoji": true
}
}
`

🛠️ Development

$3

- Node.js ≥ 18.0.0
- npm or yarn
- Git

$3

`bash
git clone https://github.com/GLINCKER/commitweave.git
cd commitweave
npm install
npm run build
npm test
`

🧪 Testing & Quality Assurance

CommitWeave maintains exceptional quality through comprehensive testing across multiple dimensions:

$3

- Platform Compatibility: 6/6 tests passed (100% success rate)
- AI Functionality: 6/6 AI tests passed with fallback validation
- Performance: 24ms startup time (12x better than 300ms target)
- VS Code Integration: All extension commands validated
- Fallback Behavior: 5/5 network failure scenarios handled gracefully

$3

- Operating Systems: macOS, Linux, Windows
- Shells: zsh, bash, PowerShell, Command Prompt
- Terminals: Terminal.app, iTerm2, Windows Terminal, VS Code integrated terminal
- Full emoji and ANSI color support verified across platforms

$3

- OpenAI GPT: Full integration with API key validation
- Anthropic Claude: Complete Claude 3 model support
- Mock AI Provider: Always available as ultimate fallback
- Network Failure Handling: Graceful degradation with user warnings
- Invalid API Key Detection: Automatic fallback to Mock AI

$3

`bash

Run performance benchmarks

npm run bench

Results: ~24ms cold-start (target: ≤300ms)

13x performance improvement achieved

`

$3

`bash

Cross-platform compatibility testing

npx tsx scripts/test-cross-platform.ts

AI functionality and fallback testing

npx tsx scripts/test-ai-functionality.ts
npx tsx scripts/test-ai-fallback.ts

VS Code extension integration testing

npx tsx scripts/test-vscode-integration.ts

Performance benchmarking

npm run bench
`

$3

- Platform Results: docs/platform-compatibility.md
- Test Artifacts: docs/testing-reports/` directory
- File Structure: docs/file-map.md

🤝 Contributing

We welcome contributions! Please read our Contributing Guide for:

- 🔧 Local development setup
- 🧪 Testing instructions
- 📝 How to add commit types
- 🤖 Adding AI providers
- 📋 Code style guidelines

📖 Documentation & Resources

- 📚 Full Documentation - Complete guides and tutorials
- 🐛 Report Issues - Bug reports and feature requests
- 💬 Discussions - Community support and ideas
- 🚀 Releases - Latest versions and changelog
- 📦 NPM Package - Package details and stats

🔗 Beta Signup & Early Access

📝 Join the Beta Program

Get early access to new features:
- 🚀 Latest features before general release
- 💬 Direct feedback channel with our team
- 🎁 Exclusive beta-only features and themes
- 📧 Priority support and feature requests

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---