This repository offers a collection of AI-powered command-line utilities designed for developers and power users. It aims to streamline AI-assisted tasks directly within the terminal, such as code refactoring, natural language interaction, and code completion.

How It Works

The scripts leverage large language models (LLMs) via API integrations with providers like Anthropic and OpenAI. Users interact with the tools through simple terminal commands, with the underlying logic handling API calls, prompt engineering, and output formatting. The project is currently consolidating functionality into a primary tool, chatsh, which aims to provide a unified interface for various AI-driven coding and chat operations.

Quick Start & Requirements

• Install: npm install -g
• Prerequisites: Node.js, API keys for Anthropic/OpenAI (configured in ~/.config).
• Logging: Scripts log to ~/.ai by default; this behavior can be modified.

Highlighted Details

• chatsh: Unified interface for terminal-based AI chat and coding assistance.
• holefill: Vim integration for filling code snippets.
• Focus on terminal-native AI workflows.

Maintenance & Community

The project is actively being unified into the chatsh script. Older, separate scripts are available on the old-main branch. The repository is described as "gambiarra" (Portuguese for a quick, often messy, but functional solution), indicating a pragmatic development approach.

Licensing & Compatibility

Licensed under MIT. This license is permissive and generally compatible with commercial use and closed-source projects.

Limitations & Caveats

The project is described as "messy" and undergoing significant consolidation. Configuration for API keys is currently handled via file editing, with a TODO for a proper option. Logging behavior is not yet configurable via a command-line flag.