gemcli 1.0.3__tar.gz

gemcli-1.0.3/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to GemCLI will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.2] - 2026-01-22
+
+### Documentation
+- Improved installation instructions with clearer option ordering
+- Added pipx installation method with automatic PATH setup
+- Enhanced troubleshooting section with multiple fix options for 'gem' command not found
+- Clarified quick-start guidance prioritizing pip (universal) over pipx (better but requires setup)
+
+## [1.0.1] - 2026-01-22
+
+### Documentation
+- Removed emojis from all documentation for professional presentation
+- Made README more detailed and enterprise-ready
+- Removed repository links from package metadata
+- Updated description to emphasize code completions, automation, and image generation
+
+## [1.0.0] - 2026-01-22
+
+### Added
+- **Four Operating Modes**: Chat, Semi-Agent, Agent, and Image Generation
+- **File Operations**: Read, edit, search, and create files in Semi-Agent and Agent modes
+- **System Command Execution**: Control system operations (open apps, adjust brightness/volume, etc.)
+- **Git Integration**: Auto-commit, push, and AI-generated commit messages
+- **Diff Viewer**: Preview changes before applying with VS Code or terminal
+- **Theme Support**: 6 color schemes (Cyan, Pink, Gold, Green, Purple, White)
+- **File Path Autocomplete**: Claude-style file path completion in Semi-Agent and Agent modes
+- **Workspace Search**: Autonomous file discovery in Agent mode
+- **Image Generation**: Create AI-generated images with customizable save locations
+- **Browser Cookie Auth**: Automatic session extraction from Chrome, Edge, Firefox
+- **Safety Features**: Built-in protections against destructive system commands and file operations
+
+### Commands
+- `/help` - Display comprehensive help with mode capabilities
+- `/exit` or `/quit` - Exit current mode
+- `/clear` - Clear terminal screen
+- `/mode` - Switch between operating modes
+- `/status` - Show git repository status
+- `/commit` - Commit changes with AI-generated message
+- `/push` - Push commits to remote repository
+
+### Security
+- Client-side only - no server component
+- Session tokens never leave local machine
+- No file deletion commands allowed
+- Safe system command execution only
+
+### Documentation
+- Comprehensive README with installation guides
+- QUICKSTART.md for rapid onboarding
+- SYSTEM_COMMANDS.md for system control features
+- GIT_INTEGRATION.md for version control workflows
+- PUBLISH.md for package distribution
+
+---
+
+## [1.0.1] - 2026-01-22
+
+### Changed
+- Updated package description for clarity and professionalism
+- Removed emojis from documentation for enterprise readiness
+- Enhanced README with detailed getting started instructions
+- Improved first-time setup documentation
+- Made all documentation more formal and professional
+- Removed repository links from package metadata
+
+### Improved
+- More comprehensive installation instructions
+- Clearer mode descriptions
+- Better workflow examples with detailed explanations
+
+---
+
+## [Unreleased]
+
+### Planned
+- Multi-language support
+- Custom system command templates
+- Plugin system for extensibility
+- Cloud sync for settings
+- Team collaboration features

gemcli-1.0.3/GIT_INTEGRATION.md

@@ -0,0 +1,112 @@
+# Git Integration Guide
+
+## Overview
+The Gemini CLI now includes full Git integration with AI-powered commit message generation.
+
+## Features
+
+### 1. Git Commands
+Available in Ask and Semi-Agent modes:
+
+- **`/status`** - Show current branch and changes
+- **`/commit`** - AI-generated commit message with confirmation
+- **`/push`** - Push commits to remote repository
+
+### 2. Auto-Commit Workflow
+After modifying files in Semi-Agent mode:
+1. Files are written to disk
+2. CLI detects you're in a git repository
+3. Prompts: "Would you like to commit these changes?"
+4. If yes, AI generates a smart commit message based on the diff
+5. You review and confirm the commit message
+6. Changes are committed
+
+### 3. AI Commit Messages
+The AI analyzes:
+- Git diff of all changes
+- File paths modified
+- Context from the conversation
+
+It generates:
+- Conventional commit format (feat:, fix:, refactor:, etc.)
+- Clear, concise descriptions
+- Multi-file summaries when needed
+
+## Usage Examples
+
+### Check Status
+```
+You: /status
+```
+Output:
+```
+◆ Git Status
+Branch: main
+
+ M gemini_cli.py
+ M README.md
+```
+
+### Commit Changes
+```
+You: /commit
+```
+Output:
+```
+◆ Generating commit message...
+
+◆ Suggested commit message:
+feat: add git integration with AI-powered commit messages
+
+Commit with this message?
+◆ Yes, commit
+◆ No, cancel
+```
+
+### Push to Remote
+```
+You: /push
+```
+Output:
+```
+◆ Pushing to remote...
+✓ Pushed successfully
+```
+
+### Auto-Commit After File Modifications
+In Semi-Agent mode, after files are modified:
+```
+✓ Modified: gemini_cli.py
+✓ Created: GIT_INTEGRATION.md
+
+◆ Would you like to commit these changes?
+
+◆ Yes, generate commit message
+◆ No, skip
+```
+
+## Technical Details
+
+### Functions Added
+- `get_git_status()` - Checks repository status, branch, and changes
+- `generate_commit_message(chat, modified_files)` - AI-generated commit messages
+- `git_commit(message, files)` - Commits changes with message
+- `git_push()` - Pushes to remote repository
+
+### Integration Points
+- Commands added to chat loop after `/clear` handler
+- Auto-commit prompt added after file write operations
+- Uses existing chat session for commit message generation
+- Subprocess with CREATE_NO_WINDOW flag for silent execution on Windows
+
+## Benefits
+1. **Smart Commit Messages** - AI understands context and generates meaningful messages
+2. **Seamless Workflow** - No need to switch to terminal
+3. **Review & Confirm** - Always see commit message before committing
+4. **Conventional Commits** - Follows standard commit message conventions
+5. **File Tracking** - Automatically stages modified files
+
+## Requirements
+- Git installed and accessible from command line
+- Repository must be initialized (`git init`)
+- Remote configured for push operations

gemcli-1.0.3/INSTALL.md

@@ -0,0 +1,238 @@
+# GEM CLI 💎
+
+Beautiful terminal interface for Gemini AI with intelligent Git integration and AI-powered coding assistance.
+
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![Python](https://img.shields.io/badge/python-3.8+-blue.svg)
+
+## ✨ Features
+
+- **🤖 Multiple Modes**
+  - **Ask Mode**: Chat with Gemini AI
+  - **Semi-Agent Mode**: AI coding assistant that can read, modify, and create files
+  - **Image Generation**: Create stunning images from text prompts
+
+- **🔧 Git Integration**
+  - AI-generated commit messages
+  - Smart branch management
+  - Automated commit & push workflows
+  - `/status`, `/commit`, `/push` commands
+
+- **📁 File Management**
+  - Read files with `/path/to/file.py` syntax
+  - VS Code diff preview for changes
+  - Accept/reject modifications
+  - Multi-file operations
+
+- **🎨 Beautiful UI**
+  - Gradient ASCII art banner
+  - Customizable color themes
+  - Rich markdown rendering
+  - Diamond (◆) indicators
+
+- **🔒 100% Private**
+  - Client-side only (no server)
+  - Your data stays on your machine
+  - Secure cookie authentication
+
+## 📦 Installation
+
+### Option 1: Install from Source (Recommended)
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/gem-cli.git
+cd gem-cli
+
+# Install globally
+pip install .
+```
+
+### Option 2: Install in Development Mode
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/gem-cli.git
+cd gem-cli
+
+# Install in editable mode
+pip install -e .
+```
+
+### Option 3: Install from PyPI (when published)
+
+```bash
+pip install gem-cli
+```
+
+### Option 4: Direct from GitHub
+
+```bash
+pip install git+https://github.com/yourusername/gem-cli.git
+```
+
+## 🚀 Quick Start
+
+After installation, simply run:
+
+```bash
+gem
+```
+
+Or use the alternative command:
+
+```bash
+gemcli
+```
+
+### First-Time Setup
+
+1. Run `gem` to start the CLI
+2. Enter your Gemini cookies:
+   - `__Secure-1PSID`
+   - `__Secure-1PSIDTS`
+3. Choose your mode (Ask / Semi-Agent / Image Generation)
+4. Start chatting!
+
+## 📖 Usage
+
+### Basic Commands
+
+All modes support:
+- `/exit` - Exit the application
+- `/clear` - Clear the screen
+- `/mode` - Switch between modes
+
+### Semi-Agent Mode Commands
+
+Git integration:
+- `/status` - Show git status and current branch
+- `/commit` - AI-generated commit with confirmation
+- `/push` - Push commits to remote
+
+File operations:
+- `/path/to/file.py` - Read and include file in context
+- AI can suggest modifications in JSON format
+- Accept/reject changes with VS Code diff preview
+
+### Git Workflow
+
+Configure your preferences from the main menu:
+- **Commit Mode**: "Ask on exit" or "After every change"
+- **Auto Push**: Automatically push after commits
+- **Branch Selection**: Choose/create branches in Semi-Agent mode
+
+### Example Workflows
+
+**Coding Assistant:**
+```
+You: /gemini_cli.py add a new feature to handle user authentication
+```
+*AI reads the file, suggests changes, opens VS Code diff, you accept*
+
+**Git Integration:**
+```
+You: /commit
+```
+*AI analyzes changes, generates smart commit message, you confirm*
+
+**Image Generation:**
+```
+You: Create a beautiful sunset over mountains with vibrant colors
+```
+*AI generates image, saves to configured directory*
+
+## ⚙️ Configuration
+
+### Git Settings
+Access from main menu → **Git Settings**:
+- Commit timing (immediate or on exit)
+- Auto-push after commit
+- Branch selection prompts
+
+### Theme Customization
+Access from main menu → **Customize Theme**:
+- White, Cyan, Pink, Gold, Green, Purple, Hot Pink
+
+### Image Settings
+In Image Mode → **Save Settings**:
+- Configure save directory
+- Auto-complete for directory paths
+
+## 🔑 Getting Gemini Cookies
+
+1. Open [Google Gemini](https://gemini.google.com) in your browser
+2. Log in to your account
+3. Open Developer Tools (F12)
+4. Go to Application/Storage → Cookies
+5. Find and copy:
+   - `__Secure-1PSID`
+   - `__Secure-1PSIDTS`
+
+Cookies are saved locally in `.gemini_cookies.json`
+
+## 🛠️ Development
+
+### Requirements
+
+- Python 3.8+
+- Git (for git integration features)
+- VS Code (recommended for diff previews)
+
+### Install for Development
+
+```bash
+git clone https://github.com/yourusername/gem-cli.git
+cd gem-cli
+pip install -e ".[dev]"
+```
+
+### Project Structure
+
+```
+gem-cli/
+├── gemini_cli.py          # Main application
+├── pyproject.toml         # Package configuration
+├── requirements.txt       # Dependencies
+├── README.md             # This file
+├── LICENSE               # MIT License
+├── GIT_INTEGRATION.md    # Git features documentation
+└── .gitignore           # Git ignore rules
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Built with [gemini-webapi](https://github.com/HanaokaYuzu/Gemini-API) by HanaokaYuzu
+- UI powered by [Rich](https://github.com/Textualize/rich)
+- Interactive prompts by [Questionary](https://github.com/tmbo/questionary)
+
+## 📞 Support
+
+- 🐛 Report bugs: [GitHub Issues](https://github.com/yourusername/gem-cli/issues)
+- 💬 Discussions: [GitHub Discussions](https://github.com/yourusername/gem-cli/discussions)
+
+## 🗺️ Roadmap
+
+- [ ] PyPI package publication
+- [ ] More Git operations (stash, rebase, etc.)
+- [ ] Plugin system for extensions
+- [ ] Multi-language support
+- [ ] Docker containerization
+
+---
+
+Made with ❤️ by 89P13

gemcli-1.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 89P13
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gemcli-1.0.3/MANIFEST.in

@@ -0,0 +1,9 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include requirements.txt
+include QUICKSTART.md
+include GIT_INTEGRATION.md
+include SYSTEM_COMMANDS.md
+include PUBLISH.md
+include INSTALL.md