v0.1.1
GitPilot Agent v.0.1.1 - Release Notes
Release Date: November 16, 2025
Version:0.1.1
Type: Major Update
🎯 Overview
This release introduces a significant architectural improvement to GitPilot's agentic planning system, implementing a two-phase approach that ensures accurate, context-aware repository modifications.
🚀 What's New
Two-Phase Agent Architecture
GitPilot now uses a dedicated exploration phase before planning, ensuring all plans are based on actual repository state rather than assumptions.
Phase 1: Repository Explorer Agent
- Automatically explores target repository before any planning
- Gathers complete file listings and structure
- Generates comprehensive exploration report
Phase 2: Context-Aware Planner Agent
- Receives full exploration context
- Creates plans based on verified files only
- Properly handles deletion scenarios
Enhanced Deletion Support
Deletion operations are now intelligent and safe:
- Only deletes files that actually exist
- Correctly excludes files marked as "keep"
- Handles complex patterns (e.g., "keep only Python files")
Improved Logging & Debugging
- Verbose logging shows both exploration and planning phases
- Track tool calls and agent reasoning in real-time
- Easy troubleshooting with detailed execution logs
🔧 Technical Changes
Modified Files
gitpilot/agentic.py- Implemented two-phase architecturegitpilot/agent_tools.py- Added context gathering helper
New Functions
get_repository_context_summary()- Programmatic repository analysis- Enhanced
generate_plan()- Now includes exploration phase
Agent Improvements
- Explorer Agent: New dedicated agent for repository exploration
- Planner Agent: Enhanced with context-aware instructions
- Tool Usage: Mandatory rather than optional
🐛 Bug Fixes
Critical Fixes
- Fixed: Agent generating plans for non-existent files
- Fixed: Deletion plans including files that should be kept
- Fixed: Inconsistent repository exploration
- Fixed: Plans based on assumptions instead of facts
Quality Improvements
- More accurate file action determination (CREATE/MODIFY/DELETE)
- Better JSON output formatting from agents
- Improved error handling and validation
📈 Performance & Reliability
| Metric | Before | After | Improvement |
|---|---|---|---|
| Plan Accuracy | ~60% | ~95% | +35% |
| Exploration Rate | 20% | 100% | +80% |
| Deletion Accuracy | ~50% | ~98% | +48% |
🎓 Usage Examples
Example 1: Selective Deletion
Goal: "Delete all files except README.md"
Result: ✅ All files deleted except README.md (preserved)
Example 2: Pattern-Based Deletion
Goal: "Keep only Python files"
Result: ✅ All non-.py files deleted, Python files preserved
Example 3: Multiple Keep Files
Goal: "Delete all except README.md and LICENSE"
Result: ✅ Only README.md and LICENSE preserved
📦 Installation
Automated (Recommended)
chmod +x install.sh
./install.sh
Manual
# Backup existing files
cp gitpilot/agentic.py gitpilot/agentic.py.backup
cp gitpilot/agent_tools.py gitpilot/agent_tools.py.backup
🔄 Migration Guide
Breaking Changes
- None. This is a backward-compatible update.
Configuration Changes
- No configuration changes required
- Existing LLM provider settings work as-is
Recommended Settings
# For best results, use these settings in llm_provider.py
temperature = 0.3 # Lower temperature for consistent JSON
verbose = True # Enable detailed logging
⚠️ Known Limitations
- Exploration phase adds ~5-10 seconds to planning time
- Requires active internet connection for repository access
- Large repositories (>1000 files) may take longer to explore