{"id":44733450,"url":"https://github.com/kyco/termai","last_synced_at":"2026-02-15T19:23:51.520Z","repository":{"id":266040034,"uuid":"868430797","full_name":"kyco/termai","owner":"kyco","description":"termai: Rust terminal AI assistant using OpenAI APIs for intelligent CLI interactions.","archived":false,"fork":false,"pushed_at":"2026-02-12T07:26:33.000Z","size":1131,"stargazers_count":25,"open_issues_count":2,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-12T16:48:15.920Z","etag":null,"topics":["ai","chatgpt","o1-mini","openai","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/kyco.png","metadata":{"files":{"readme":"docs/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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-06T11:21:13.000Z","updated_at":"2026-02-12T07:26:36.000Z","dependencies_parsed_at":"2025-05-26T06:35:30.332Z","dependency_job_id":"9b931e51-3939-4a52-959d-d16ece71e524","html_url":"https://github.com/kyco/termai","commit_stats":null,"previous_names":["kyco/termai"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kyco/termai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyco%2Ftermai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyco%2Ftermai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyco%2Ftermai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyco%2Ftermai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kyco","download_url":"https://codeload.github.com/kyco/termai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyco%2Ftermai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29487434,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T15:33:17.885Z","status":"ssl_error","status_checked_at":"2026-02-15T15:32:53.698Z","response_time":118,"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","chatgpt","o1-mini","openai","rust"],"created_at":"2026-02-15T19:23:51.010Z","updated_at":"2026-02-15T19:23:51.509Z","avatar_url":"https://github.com/kyco.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TermAI\n\n\u003e A powerful, privacy-focused AI assistant for your terminal\n\nTermAI is a versatile command-line AI assistant built in Rust that brings the power of modern large language models directly to your terminal. It supports both OpenAI and Anthropic\nClaude APIs (now with Claude Opus 4 support) with a focus on privacy, speed, and developer productivity.\n\n![Terminal AI Assistant](https://img.shields.io/badge/Terminal-AI_Assistant-blueviolet) ![Smart Context](https://img.shields.io/badge/🧠_Smart-Context_Discovery-brightgreen) ![License: MIT](https://img.shields.io/badge/License-MIT-green.svg) ![Rust](https://img.shields.io/badge/Rust-1.70+-orange.svg)\n\n## ✨ Features\n\n- **🎯 Interactive Setup Wizard**: Get started in under 2 minutes with guided configuration\n- **🤖 Multi-Provider Support**: Works with both OpenAI and Claude APIs\n- **🚀 Claude Opus 4**: Now powered by Anthropic's most capable model with superior intelligence\n- **🧠 Smart Context Discovery**: Revolutionary intelligent project analysis that automatically selects the most relevant files\n- **🔄 AI-Powered Git Integration**: Complete Git workflow automation with intelligent commit messages, code reviews, and conflict resolution\n- **📁 Local Context Understanding**: Analyze your code and files for more relevant responses\n- **💬 Session Management**: Save and restore conversations for later reference\n- **🔒 Privacy-Focused**: Redact sensitive information before sending to APIs\n- **⚡ Developer-Optimized**: Perfect for generating code, explaining concepts, and assisting with daily dev tasks\n- **🖥️ Fully Terminal-Based**: No web interfaces or external dependencies needed\n- **🎨 Beautiful Interface**: Progress indicators, colors, and intuitive subcommands\n\n## 🚀 Quick Start\n\n### 1. Install TermAI\n\n```bash\n# Prerequisites: Rust and Cargo (https://www.rust-lang.org/tools/install)\ngit clone https://github.com/kyco/termai.git\ncd termai\ncargo install --path .\n```\n\n### 2. Interactive Setup (⭐ Recommended)\n\nGet started instantly with our **interactive setup wizard**:\n\n```bash\ntermai setup\n```\n\nThe setup wizard will guide you through:\n- **Provider Selection**: Choose Claude, OpenAI, or both\n- **API Key Configuration**: Enter your keys with live validation\n- **Default Provider**: Set your preferred AI assistant\n\n**✨ Takes less than 2 minutes and validates your API keys automatically!**\n\n### 3. Start Chatting\n\n```bash\n# Ask anything!\ntermai \"What is the capital of France?\"\n\n# 🧠 Smart Context Discovery (auto-selects relevant files!)\ntermai --smart-context \"Refactor this to use async/await\" .\n\n# Traditional local context\ntermai \"Create a README for this project\" .\n\n# Work with specific files\ntermai \"Explain this function\" ./src/main.rs\n```\n\n## 🧠 Smart Context Discovery\n\n**The game-changer for developer productivity.** Smart Context Discovery automatically analyzes your project and intelligently selects the most relevant files for your AI assistant, eliminating the need to manually specify files and ensuring optimal token usage.\n\n### 🎯 Before vs After\n\n**❌ Before (Manual Context):**\n```bash\n# You had to guess which files were relevant\ntermai \"Add error handling to the user authentication\" \\\n  ./src/auth/login.rs \\\n  ./src/auth/middleware.rs \\\n  ./src/auth/tokens.rs \\\n  ./src/errors.rs \\\n  ./src/models/user.rs\n# Often missing important files or including irrelevant ones\n```\n\n**✅ After (Smart Context Discovery):**\n```bash\n# AI automatically finds ALL relevant files\ntermai --smart-context \"Add error handling to the user authentication\" .\n\n# 🧠 Smart Context automatically discovered:\n# ✓ auth/login.rs (entry point, 95% relevance)  \n# ✓ auth/middleware.rs (dependency, 87% relevance)\n# ✓ auth/tokens.rs (dependency, 82% relevance) \n# ✓ errors.rs (related functionality, 78% relevance)\n# ✓ models/user.rs (data model, 71% relevance)\n# ✗ Excluded: tests, docs, config files (not relevant to request)\n```\n\n### ⚡ Key Benefits\n\n- **🎯 90%+ Accuracy**: Finds the right files automatically using advanced relevance scoring\n- **🚀 10x Faster**: No more manually hunting for relevant files\n- **💡 Token Optimized**: Stays within API limits while including maximum relevant context\n- **🔍 Multi-Language**: Supports Rust, JavaScript/TypeScript, Python, Go, Java, Kotlin projects\n- **📊 Intelligent Ranking**: Prioritizes entry points, recent changes, and dependency relationships\n- **⚙️ Configurable**: Use `.termai.toml` to customize patterns and preferences\n\n### 🛠️ How It Works\n\nSmart Context Discovery uses sophisticated algorithms to analyze your project:\n\n1. **🔍 Project Detection**: Automatically identifies project type (Rust, JS, Python, etc.)\n2. **📁 File Discovery**: Scans project structure and identifies important files\n3. **🧮 Relevance Scoring**: Analyzes file importance using multiple factors:\n   - **Recent Changes**: Git history and staging status\n   - **Entry Points**: main.rs, index.js, __init__.py, etc.\n   - **Dependencies**: Cross-file import/reference analysis  \n   - **File Types**: Prioritizes source code over config/docs\n   - **Query Matching**: Keywords in your request vs file content\n4. **🎯 Smart Selection**: Optimally selects files within token budget\n5. **⚖️ Token Management**: Automatically chunks large projects across multiple requests\n\n### 🚀 Usage Examples\n\n#### Basic Smart Context\n```bash\n# Automatically find relevant files for any task\ntermai --smart-context \"Optimize database queries\" .\ntermai --smart-context \"Add logging to error handlers\" .\ntermai --smart-context \"Implement user permissions\" .\n```\n\n#### Large Projects (Automatic Chunking)\n```bash\n# Works even with massive codebases - chunks intelligently\ntermai --smart-context \"Review security vulnerabilities\" /path/to/large-project\n\n# 📊 Smart Context found 847 files (12,450 tokens)\n# ⚖️ Exceeds budget (4,000 tokens) - using chunking strategy\n# 🎯 Chunk 1/3: Core auth \u0026 security modules (3,892 tokens)\n# 🎯 Chunk 2/3: API endpoints \u0026 middleware (3,745 tokens)  \n# 🎯 Chunk 3/3: Database \u0026 validation logic (3,234 tokens)\n```\n\n#### Custom Configuration\n```bash\n# Create .termai.toml in your project root\ncat \u003e .termai.toml \u003c\u003c EOF\n[context]\nmax_tokens = 6000\ninclude = [\"src/**/*.rs\", \"tests/**/*.rs\"]\nexclude = [\"target/**\", \"*.log\"]\npriority_patterns = [\"main.rs\", \"lib.rs\", \"mod.rs\"]\n\n[project]  \ntype = \"rust\"\nentry_points = [\"src/main.rs\", \"src/lib.rs\"]\nEOF\n\n# Smart context will respect your configuration\ntermai --smart-context \"Add comprehensive error handling\" .\n```\n\n### 🎛️ Advanced Features\n\n#### Context Preview\n```bash\n# See what files would be selected before processing\ntermai --smart-context --preview \"Add authentication\" .\n\n# 📊 Smart Context Selection Summary\n# ═══════════════════════════════════\n# 🎯 Selected 8 files\n# 📝 Estimated tokens: ~3,247\n# 💾 Token budget: 4,000\n# \n# 📁 Selected Files (by relevance):\n#  1. ████████████ (89.2%) main.rs\n#     💬 /src/main.rs\n#     🏷️ EntryPoint, RecentlyModified\n#  2. ██████████ (76.5%) auth.rs  \n#     💬 /src/auth.rs\n#     🏷️ QueryRelevant, Dependency\n```\n\n#### Multi-Session for Large Projects\n```bash\n# Automatically manages conversation across multiple sessions\ntermai --smart-context --session auth_refactor \"Modernize authentication system\" .\n\n# Creates linked sessions for comprehensive project analysis:\n# Session 1: auth_refactor_core (authentication logic)\n# Session 2: auth_refactor_api (API endpoints) \n# Session 3: auth_refactor_db (database integration)\n```\n\n#### Supported Project Types\n\n| Language | Project Files | Entry Points | Dependencies |\n|----------|---------------|--------------|-------------|\n| **Rust** | Cargo.toml | main.rs, lib.rs | mod declarations, use statements |\n| **JavaScript/TypeScript** | package.json | index.js/ts, main.js/ts | import/require statements |\n| **Python** | pyproject.toml, setup.py | main.py, __init__.py | import statements |\n| **Go** | go.mod | main.go | import declarations |\n| **Java** | pom.xml, build.gradle | Main.java, Application.java | import statements |\n| **Kotlin** | build.gradle.kts | Main.kt, Application.kt | import declarations |\n\n### ⚙️ Configuration Options\n\nCreate a `.termai.toml` file in your project root:\n\n```toml\n[context]\nmax_tokens = 4000              # Token budget per request\ninclude = [\"src/**/*.rs\"]      # Files to include (glob patterns)  \nexclude = [\"target/**\"]        # Files to exclude (glob patterns)\npriority_patterns = [\"main.rs\"] # High-priority file patterns\nenable_cache = true            # Cache analysis results\n\n[project]\ntype = \"rust\"                  # Override project type detection\nentry_points = [\"src/main.rs\"] # Override entry point detection\n```\n\n---\n\n## 📋 Commands Reference\n\nTermAI offers intuitive subcommands for all your AI assistant needs:\n\n### 🚀 Quick Start Commands\n\n```bash\n# Interactive setup (recommended first step)\ntermai setup\n\n# Ask a quick question\ntermai ask \"How do I implement binary search in Rust?\"\n\n# Start a conversation\ntermai chat\ntermai chat \"Let's discuss software architecture\"\n\n# Smart context analysis\ntermai chat --smart-context \"Refactor this authentication system\" .\n```\n\n### 🧠 Smart Context Discovery\n\n```bash\n# Automatic file discovery and analysis\ntermai ask --smart-context \"Add error handling\" .\ntermai chat --smart-context \"Review security issues\" .\n\n# Preview what files would be selected\ntermai ask --smart-context --preview-context \"Optimize performance\" .\n\n# Customize token limits and chunking\ntermai ask --smart-context --max-context-tokens 6000 \"Explain the codebase\" .\ntermai chat --smart-context --chunked-analysis --chunk-strategy hierarchical \"Full code review\" .\n\n# Target specific context\ntermai ask --smart-context --context-query \"database connections\" \"Fix connection pooling\" .\n```\n\n### ⚙️ Configuration Management\n\n```bash\n# Interactive setup wizard\ntermai setup                           # Complete guided setup\ntermai setup --auto-accept            # Non-interactive with defaults\ntermai setup --skip-validation        # Skip API key validation\n\n# View and manage configuration\ntermai config show                     # Display current settings\ntermai config env                      # Show environment variables\ntermai config reset                    # Clear all configuration\n\n# Set API keys and providers\ntermai config set-claude KEY           # Configure Claude API\ntermai config set-openai KEY           # Configure OpenAI API  \ntermai config set-provider claude      # Set default provider\n```\n\n### 💬 Session Management\n\n```bash\n# List and manage sessions\ntermai sessions list                   # Show all sessions\ntermai sessions list --limit 5 --sort date # Show recent 5 sessions\ntermai sessions show session_name      # View session details\ntermai sessions delete session_name    # Remove a session\n\n# Use sessions in conversations\ntermai chat --session my_project       # Continue specific session\ntermai ask --session code_review \"Explain this function\" ./src/lib.rs\n```\n\n### 🔒 Privacy \u0026 Redaction\n\n```bash\n# Manage redaction patterns\ntermai redact add \"SECRET_KEY\"          # Add sensitive text pattern\ntermai redact add \"user_.*@company.com\" # Add regex pattern\ntermai redact list                      # Show all patterns\ntermai redact remove \"SECRET_KEY\"       # Remove a pattern\ntermai redact reset                     # Clear all patterns\n```\n\n### 🔧 Advanced Features\n\n```bash\n# Custom context directories\ntermai ask --directories src,tests,docs \"Document this project\" .\ntermai chat --directory src --exclude \"*.test.js,node_modules\" \"Review the code\" .\n\n# Provider and model selection\ntermai ask --provider openai \"Generate API documentation\" .\ntermai chat --provider claude --model claude-3-5-sonnet-20241022 \"Code review\" .\n\n# System prompts and customization\ntermai ask --system-prompt \"You are a Rust expert\" \"Optimize this code\" ./main.rs\ntermai chat --session rust_tutor --system-prompt \"Act as a patient teacher\"\n```\n\n### 🐚 Shell Completion\n\n```bash\n# Generate completion scripts\ntermai completion bash                  # Basic Bash completion\ntermai completion zsh                   # Basic Zsh completion  \ntermai completion fish                  # Basic Fish completion\ntermai completion powershell            # PowerShell completion\n\n# Enhanced completions with dynamic features\ntermai completion enhanced bash         # Bash with session name completion\ntermai completion enhanced zsh          # Zsh with smart suggestions\ntermai completion enhanced fish         # Fish with context-aware completion\n\n# Installation examples\ntermai completion bash \u003e ~/.termai-completion.bash\necho 'source ~/.termai-completion.bash' \u003e\u003e ~/.bashrc\n```\n\n### 🔍 Environment Variables\n\nTermAI supports environment variables for flexible configuration:\n\n```bash\n# API Keys\nexport OPENAI_API_KEY=\"your-key\"\nexport CLAUDE_API_KEY=\"your-key\"\n\n# Provider settings  \nexport TERMAI_PROVIDER=\"claude\"\nexport TERMAI_MODEL=\"claude-3-5-sonnet-20241022\"\n\n# Context settings\nexport TERMAI_MAX_CONTEXT_TOKENS=\"4000\"\nexport TERMAI_SYSTEM_PROMPT=\"You are a helpful coding assistant\"\n\n# View current environment\ntermai config env\n```\n\n## 📖 Usage Examples\n\n### 🎯 Common Workflows\n\n#### Development Assistant\n```bash\n# Quick coding questions\ntermai ask \"How do I implement a thread pool in Rust?\"\ntermai ask \"Best practices for error handling in REST APIs\"\n\n# Code analysis with smart context\ntermai ask --smart-context \"Find potential memory leaks\" .\ntermai ask --smart-context \"Suggest performance optimizations\" .\n\n# Interactive development session\ntermai chat --session dev_work --smart-context\n# Then continue the conversation naturally\n```\n\n#### Code Review \u0026 Documentation\n```bash\n# Review recent changes\ngit diff | termai ask \"Review this code change for potential issues\"\n\n# Generate commit messages\ngit diff --staged | termai ask \"Write a clear commit message for these changes\"\n\n# Document your code\ntermai ask --smart-context \"Generate comprehensive README documentation\" .\ntermai ask --directory src \"Create API documentation for these modules\" .\n```\n\n#### Learning \u0026 Exploration  \n```bash\n# Understand complex codebases\ntermai ask --smart-context --preview-context \"Explain the architecture\" .\ntermai chat --session learning --smart-context \"How does the authentication system work?\" .\n\n# Deep dive into specific topics\ntermai chat --session rust_patterns --system-prompt \"You are a Rust expert\"\n```\n\n#### Project Management\n```bash\n# Analyze project health\ntermai ask --smart-context \"Identify technical debt and areas for refactoring\" .\ntermai ask --smart-context \"Suggest project structure improvements\" .\n\n# Generate project assets\ntermai ask --smart-context \"Create a comprehensive test plan\" .\ntermai ask --directories src,docs \"Generate a contributing guide\" .\n```\n\n## 🔄 AI-Powered Git Integration\n\nTermAI revolutionizes Git workflows with intelligent automation that understands your code and context. Say goodbye to repetitive Git tasks and hello to AI-powered development workflows.\n\n### ✨ Complete Git Workflow Automation\n\n**🤖 Smart Commit Generation**\n```bash\n# AI analyzes your staged changes and generates perfect commit messages\ntermai commit\n\u003e 📝 Analyzing staged changes...\n\u003e \n\u003e Suggested commit message:\n\u003e feat(auth): add OAuth2 integration with token refresh\n\u003e \n\u003e - Add OAuth2Provider trait implementation\n\u003e - Implement token refresh mechanism  \n\u003e - Add comprehensive error handling\n\u003e - Update tests for new auth flow\n\u003e \n\u003e [e]dit, [a]ccept, [r]egenerate, [c]ancel?\n\n# Quick auto-commit mode\ntermai commit --auto\n```\n\n**🔍 Intelligent Code Review**\n```bash\n# Get AI-powered code review before committing\ntermai review\n\u003e 🔍 Reviewing staged changes...\n\u003e \n\u003e ⚠️  Security Issues:\n\u003e src/auth.rs:42 - Use SecretString instead of String for passwords\n\u003e \n\u003e 🚀 Performance:\n\u003e src/auth.rs:58 - Consider caching OAuth tokens to reduce API calls\n\u003e \n\u003e ✅ Positive Findings:\n\u003e - Excellent test coverage for new functionality\n\u003e - Follows consistent error handling patterns\n\n# Focus on specific areas\ntermai review --security --performance\n```\n\n**🌿 Smart Branch Management**\n```bash\n# Analyze your current branch with AI insights\ntermai branch-summary\n\u003e 📊 Branch: feature/oauth (5 commits ahead of main)\n\u003e \n\u003e AI Analysis:\n\u003e - No breaking changes detected\n\u003e - Well-structured commits with clear progression\n\u003e - Good test coverage maintained\n\u003e \n\u003e Suggested PR Description:\n\u003e ## OAuth2 Integration\n\u003e This PR adds comprehensive OAuth2 authentication support...\n\n# Generate PR/MR descriptions automatically\ntermai branch-summary --pr-description\n```\n\n**⚔️ Conflict Resolution Assistant**\n```bash\n# AI-powered merge conflict analysis and resolution\ntermai conflicts detect\n\u003e ⚔️  Found 3 merge conflicts in 2 files\n\u003e \n\u003e src/auth.rs:\n\u003e - Complexity: Medium (structural changes to auth module)\n\u003e - Strategy: Manual review recommended (business logic conflict)\n\u003e - Confidence: 85% - can suggest resolution approach\n\u003e \n\u003e tests/auth_test.rs:\n\u003e - Complexity: Low (test assertion updates)  \n\u003e - Strategy: Auto-resolution possible\n\u003e - Confidence: 95% - safe to auto-resolve\n\n# Interactive conflict resolution\ntermai conflicts resolve --interactive\n```\n\n**🔄 Interactive Rebase Guidance**\n```bash\n# AI-assisted interactive rebase with smart suggestions\ntermai rebase start main --count 5\n\u003e 🔄 Planning interactive rebase of last 5 commits\n\u003e \n\u003e AI Recommendations:\n\u003e ✅ Squash commits #2 and #3 (both fix typos in same function)\n\u003e ✅ Reword commit #4 (improve message clarity)\n\u003e ⚠️  Keep commit #1 separate (substantial feature addition)\n\u003e \n\u003e [a]pply suggestions, [m]anual edit, [c]ancel?\n\n# Continue interrupted rebase with AI guidance\ntermai rebase continue\n```\n\n**🏷️ Release Management**\n```bash\n# AI-powered tag creation with semantic versioning\ntermai tag create --from-tag v1.2.0\n\u003e 🏷️  Analyzing changes since v1.2.0...\n\u003e \n\u003e Detected Changes:\n\u003e - 3 new features (OAuth, rate limiting, caching)\n\u003e - 2 bug fixes (auth timeout, memory leak)\n\u003e - No breaking changes\n\u003e \n\u003e Suggested Version: v1.3.0 (minor)\n\u003e \n\u003e Generated Release Notes:\n\u003e ## v1.3.0 - Enhanced Authentication \u0026 Performance\n\u003e \n\u003e ### 🚀 New Features\n\u003e - OAuth2 integration with multiple providers\n\u003e - Advanced rate limiting system\n\u003e - Intelligent response caching\n```\n\n**🪝 Git Hooks Automation**\n```bash\n# Install AI-powered Git hooks for automated quality assurance\ntermai hooks install-all\n\u003e 🪝 Installing TermAI Git hooks...\n\u003e ✅ Pre-commit: Code quality analysis\n\u003e ✅ Commit-msg: Message validation\n\u003e ✅ Pre-push: Final review check\n\u003e ✅ Post-commit: Success insights\n\n# Check hooks status\ntermai hooks status\n```\n\n### 🎯 Smart Git Commands Reference\n\n| Command | Purpose | AI Features |\n|---------|---------|-------------|\n| `termai commit` | Generate commit messages | Analyzes diffs, follows conventions, suggests scope |\n| `termai review` | Code review assistance | Security scan, performance check, style validation |\n| `termai branch-summary` | Branch analysis | Change summary, PR descriptions, impact analysis |\n| `termai conflicts` | Merge conflict help | Strategy suggestions, complexity analysis, auto-resolution |\n| `termai rebase` | Interactive rebase guide | Commit squashing, message improvements, conflict prediction |\n| `termai tag` | Release management | Semantic versioning, release notes, change categorization |\n| `termai hooks` | Git hooks management | Quality gates, automation, integration with existing tools |\n| `termai stash` | Stash operations | Smart naming, conflict detection, restoration guidance |\n\n### 🚀 Workflow Examples\n\n**Daily Development Flow**\n```bash\n# Make changes\ngit add .\n\n# AI-powered commit\ntermai commit\n\u003e feat(api): add user profile endpoints with validation\n\n# AI code review\ntermai review\n\u003e ✅ No issues found, ready to push!\n\n# Push with confidence\ngit push\n```\n\n**Feature Branch Workflow**\n```bash\n# Create and work on feature branch\ngit checkout -b feature/user-profiles\n\n# Multiple commits...\ngit add . \u0026\u0026 termai commit --auto\ngit add . \u0026\u0026 termai commit --auto\n\n# Clean up commits before merging\ntermai rebase start main --interactive\n\u003e Squashed 3 commits into coherent feature story\n\n# Generate PR description\ntermai branch-summary --pr-description\n\u003e ## User Profile Management\n\u003e Comprehensive user profile system with validation...\n\n# Create PR with generated description\n```\n\n**Release Preparation**\n```bash\n# Analyze changes for release\ntermai tag create\n\u003e Suggested version: v2.1.0\n\u003e \n\u003e Breaking Changes: None\n\u003e New Features: 4\n\u003e Bug Fixes: 2\n\n# Create release with AI-generated notes\ngit tag v2.1.0 -m \"$(termai tag release-notes --from v2.0.0)\"\n```\n\n### 🎬 Workflow Demos\n\nSee TermAI's Git integration in action:\n\n![Commit Generation Demo](https://github.com/user/termAI/raw/main/docs/gifs/commit-demo.gif)\n*AI-powered commit message generation with interactive refinement*\n\n![Code Review Demo](https://github.com/user/termAI/raw/main/docs/gifs/review-demo.gif)\n*Comprehensive code review with security and performance analysis*\n\n![Branch Analysis Demo](https://github.com/user/termAI/raw/main/docs/gifs/branch-demo.gif)\n*Smart branch analysis and PR description generation*\n\n![Conflict Resolution Demo](https://github.com/user/termAI/raw/main/docs/gifs/conflicts-demo.gif)\n*AI-assisted merge conflict resolution with strategy recommendations*\n\n### 🎨 Beautiful Terminal Experience\n\nAll Git commands feature:\n- **🎨 Rich Colors**: Visual distinction for different types of information\n- **📊 Progress Indicators**: Real-time feedback during analysis\n- **🎯 Interactive Prompts**: Smart defaults with easy customization\n- **💡 Contextual Tips**: Learning opportunities built into the workflow\n- **⚡ Fast Performance**: Efficient analysis even for large repositories\n\n### 🔧 Configuration \u0026 Customization\n\nCreate `.termai.toml` in your project root:\n\n```toml\n[git]\n# Commit message preferences\ncommit_template = \"conventional\"  # conventional, minimal, detailed\nauto_stage = false               # Auto-stage files before commit\nrequire_scope = true            # Require scope in commit messages\n\n# Code review settings  \nreview_depth = \"standard\"       # quick, standard, thorough\nsecurity_focus = true          # Enable security analysis\nperformance_focus = true       # Enable performance analysis\n\n# Hook configuration\nhooks_enabled = [\"pre-commit\", \"commit-msg\"]\nhook_strictness = \"warn\"       # warn, error, off\n```\n\n---\n\n### 🎯 Session-Based Workflows\n\n```bash\n# Start focused development sessions\ntermai chat --session auth_refactor --smart-context \"Let's refactor the authentication system\" .\n\n# Continue multi-part conversations\ntermai chat --session auth_refactor  # Resumes previous conversation\n\n# Organize work by project\ntermai sessions list                  # See all active sessions\ntermai sessions show auth_refactor    # Review session history\ntermai sessions delete old_session    # Clean up completed work\n```\n\n### 🔒 Privacy-First Development\n\n```bash\n# Set up redaction patterns for your organization\ntermai redact add \"ACME_API_KEY_.*\"           # Redact API keys\ntermai redact add \"user_\\d+@company\\.com\"     # Redact user emails  \ntermai redact add \"password.*=.*\"             # Redact password assignments\n\n# Verify redaction is working\ntermai redact list                            # Check active patterns\n\n# Safe analysis of sensitive codebases\ntermai ask --smart-context \"Review security practices\" .  # Redaction applied automatically\n```\n\n## 🏗️ Architecture\n\nTermAI is built with a clean architecture focusing on:\n\n- **Repository Pattern**: Data access through well-defined interfaces\n- **Service Layer**: Business logic separated from presentation\n- **Modular Design**: Support for multiple LLM providers\n- **Local Storage**: SQLite for configuration and session persistence\n\n## 🤝 Contributing\n\nContributions are welcome! Here's how to get started:\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Commit your changes: `git commit -m 'Add amazing feature'`\n4. Push to the branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\nPlease ensure your code follows the project's coding style and includes appropriate tests.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🔮 Future Plans\n\n- Stream responses for faster feedback\n- ✅ Enhanced shell completion with dynamic session/model completion\n- Voice input/output support\n- Additional LLM providers (Gemini, Cohere, etc.)\n- Custom fine-tuned models\n- Enhanced smart context with semantic code analysis\n- Team collaboration features for shared context templates\n- Man page generation for offline documentation\n- Command discovery aids with intelligent suggestions\n\n---                                                                                                                                                                                                                \n\nMade with ❤️ by [kyco](https://github.com/kyco)    ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkyco%2Ftermai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkyco%2Ftermai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkyco%2Ftermai/lists"}