UBOS Asset Marketplace: aicommit - Supercharge Your Git Commits with AI

In the rapidly evolving landscape of software development, efficiency and clarity are paramount. Every commit tells a story, and crafting meaningful commit messages is a crucial, yet often overlooked, aspect of this narrative. But what if AI could take the tedium out of writing commit messages, ensuring consistency and clarity across your projects? Enter aicommit, a CLI tool available on the UBOS Asset Marketplace that leverages the power of Large Language Models (LLMs) to generate concise, descriptive git commit messages, significantly streamlining your workflow.

aicommit acts as an intelligent assistant, analyzing your code changes and automatically crafting commit messages that accurately reflect the modifications you’ve made. This tool seamlessly integrates into your existing Git workflow, offering a range of features designed to enhance productivity and code maintainability.

Use Cases: Revolutionizing Your Development Workflow

• Accelerated Development Cycles: Automate the commit message generation process, freeing up valuable time for developers to focus on core coding tasks. Instead of spending minutes crafting the perfect message, aicommit delivers a relevant and descriptive message in seconds.
• Improved Codebase Clarity: Enforce consistent commit message standards across your team, leading to a more understandable and maintainable codebase. Clear, AI-generated messages ensure that every change is well-documented and easily traceable.
• Onboarding Efficiency: Reduce the learning curve for new team members by providing them with a codebase that boasts consistently clear commit messages. This allows them to quickly grasp the history and purpose of each code modification.
• Enhanced Collaboration: Facilitate smoother collaboration among developers by ensuring everyone is on the same page regarding code changes. AI-powered messages minimize ambiguity and prevent misunderstandings.
• Personal Projects: Even for solo developers, aicommit improves the clarity of your personal projects, making it easier to understand the evolution of your code over time.
• Open Source Contributions: When contributing to open-source projects, clear and descriptive commit messages are essential. aicommit ensures that your contributions are easily understood and appreciated by maintainers.

Key Features: Unleashing the Power of AI-Driven Commit Messages

• LLM-Powered Message Generation: At its core, aicommit employs LLMs to analyze your code changes and generate insightful commit messages. This intelligent process ensures that your messages are not only accurate but also contextually relevant.
• Multiple LLM Provider Support: aicommit offers unparalleled flexibility with its support for a diverse range of LLM providers:
  • OpenRouter: Access a wide selection of cutting-edge LLMs through OpenRouter’s unified API.
  • Simple Free OpenRouter: Utilize OpenRouter’s free models without the complexity of manual selection. aicommit automatically selects the best available free model and intelligently handles failover and model performance tracking.
  • Ollama: Leverage local LLMs with Ollama for offline functionality and data privacy.
  • OpenAI-Compatible Endpoints: Integrate with various OpenAI-compatible endpoints, including LM Studio and local OpenAI proxies, for maximum customization.
• Simple Free Mode: The Simple Free mode provides a seamless experience for using OpenRouter’s free models. The system handles model selection, failover, and performance tracking automatically, ensuring optimal usage of free resources. This includes:
  • Automatic Model Selection: The system dynamically queries OpenRouter for available free models.
  • Intelligent Ranking: An internal ranking system prioritizes the best available free models.
  • Advanced Failover Mechanism: A sophisticated system tracks model performance and automatically switches to alternative models in case of failures.
  • Resilient Operation: The system can operate even when network connectivity to OpenRouter is unavailable, by using predefined models.
• Automated Staging and Committing: Streamline your workflow with the --add option, which automatically stages your changes before generating the commit message.
• Push Integration: Simplify your workflow further with the --push option, which automatically pushes your commits to the remote repository.
• Interactive Mode: Refine your commit messages before committing with the --dry-run option, which allows you to preview and edit the generated message.
• Watch Mode: Automate commit creation whenever changes occur with the --watch option, providing real-time backups and meticulous tracking of your progress.
• Version Control Helpers: Simplify version management with features like automatic version bumping (--version-iterate) and synchronization with Cargo.toml (--version-cargo), package.json (--version-npm), and GitHub releases (--version-github).
• Smart Retry Mechanism: Ensure reliability with a built-in retry mechanism that automatically attempts to regenerate commit messages in case of API failures.
• Easy Configuration Management: Customize aicommit to your preferences with an intuitive configuration system.
• VS Code Extension: Enhance your coding experience with the aicommit VS Code extension, which provides seamless integration within the editor.
• Verbose Mode: Get detailed information about aicommit’s operations using the --verbose flag for debugging and understanding the process.
• Automatic Upstream Branch Setup: When using --pull or --push flags, aicommit automatically handles upstream branch configuration.

Diving Deeper: Understanding the Simple Free Mode

The Simple Free mode is a standout feature, designed to provide a hassle-free experience when using OpenRouter’s free models. Let’s break down the key components of this mode:

• Three-Tier Model Status: Models are categorized into Active, Jailed, and Blacklisted statuses. Jailed models are temporarily restricted, while Blacklisted models are permanently banned.
• Counter-Based System: A counter tracks the success/failure ratio of each model. Three consecutive failures result in a model being moved to Jailed status.
• Time-Based Jail: Models are temporarily jailed for 24 hours after repeated failures, with increasing jail time for subsequent offenses.
• Blacklist Management: Models with persistent failures over multiple days are blacklisted but retried weekly.
• Success Rate Tracking: Performance history is recorded to prioritize more reliable models.
• Smart Reset: Models receive fresh chances daily, and users can manually reset the jail status with the --unjail and --unjail-all commands.
• Network Error Handling: The system distinguishes between model errors and connection issues to avoid unfairly penalizing models.

To leverage the Simple Free mode, simply provide your OpenRouter API key, and aicommit will handle the rest:

bash aicommit --add-simple-free --openrouter-api-key=<YOUR_API_KEY>

Installation and Usage: Getting Started with aicommit

Installing aicommit is a breeze:

bash npm install -g @suenot/aicommit

Or, for Rust users:

bash cargo install aicommit

Once installed, you can quickly generate commit messages:

bash git add . aicommit

Or, streamline the process further:

bash aicommit --add

Configuration: Tailoring aicommit to Your Needs

aicommit’s configuration file is stored at ~/.aicommit.json. You can easily edit it with:

bash aicommit --config

The configuration file allows you to specify global settings like the active provider and the number of retry attempts. You can also configure provider-specific settings, such as the maximum number of tokens and the temperature.

Supported LLM Providers: A World of Options

aicommit supports a variety of LLM providers, giving you the freedom to choose the best option for your needs. These providers include Simple Free OpenRouter, OpenRouter, Ollama, and OpenAI-compatible APIs. Each provider has its own set of configuration options, allowing you to fine-tune the message generation process.

OpenRouter

OpenRouter offers a vast selection of LLMs, providing access to cutting-edge models:

{ “providers”: [{ “id”: “550e8400-e29b-41d4-a716-446655440000”, “provider”: “openrouter”, “api_key”: “sk-or-v1-…”, “model”: “mistralai/mistral-tiny”, “max_tokens”: 50, “temperature”: 0.3, “input_cost_per_1k_tokens”: 0.25, “output_cost_per_1k_tokens”: 0.25 }], “active_provider”: “550e8400-e29b-41d4-a716-446655440000” }

Ollama

Ollama allows you to run LLMs locally, ensuring data privacy and offline functionality:

{ “providers”: [{ “id”: “67e55044-10b1-426f-9247-bb680e5fe0c8”, “provider”: “ollama”, “url”: “http://localhost:11434”, “model”: “llama2”, “max_tokens”: 50, “temperature”: 0.3, “input_cost_per_1k_tokens”: 0.0, “output_cost_per_1k_tokens”: 0.0 }], “active_provider”: “67e55044-10b1-426f-9247-bb680e5fe0c8” }

OpenAI-compatible API

Integrate with any service that provides an OpenAI-compatible API endpoint, offering maximum flexibility and control.

LM Studio Example

LM Studio, for example, can act as an OpenAI-compatible server. Configure aicommit like this:

bash aicommit --add-provider

Select “OpenAI Compatible” and enter:

• API Key: lm-studio (or any non-empty string)
• API URL: http://localhost:1234/v1/chat/completions (or the URL shown in LM Studio)
• Model: lm-studio-model (or any descriptive name)
• Max tokens: 50 (or adjust as needed)
• Temperature: 0.3 (or adjust as needed)

The Future of aicommit: Upcoming Features

The aicommit team is actively working on exciting new features, including:

• Hooks for Git systems (pre-commit, post-commit)
• Support for more LLM providers
• Integration with IDEs and editors
• EasyCode: VS Code integration for commit message generation directly from editor
• Command history and reuse of previous messages
• Message templates and customization options

UBOS: The Platform for AI Agent Development

aicommit is an invaluable asset for developers, and it finds its home on the UBOS (Unified Business Orchestration System) platform. UBOS is a full-stack AI Agent Development Platform designed to empower businesses by bringing AI Agents into every department. The platform offers comprehensive tools for:

• Orchestrating AI Agents: Manage and coordinate the activities of multiple AI Agents within a unified framework.
• Connecting AI Agents with Enterprise Data: Seamlessly integrate AI Agents with your organization’s data sources, enabling them to access and utilize critical information.
• Building Custom AI Agents with Your LLM Model: Leverage your own LLM models to create specialized AI Agents tailored to your specific needs.
• Multi-Agent Systems: Design and deploy complex systems of interacting AI Agents to tackle intricate business challenges.

aicommit embodies the spirit of UBOS – leveraging AI to enhance productivity and streamline workflows. By automating the creation of commit messages, aicommit allows developers to focus on what they do best: building innovative software.

Embrace the power of AI-driven commit messages with aicommit, available now on the UBOS Asset Marketplace. Transform your Git workflow and unlock new levels of efficiency and clarity in your development process.