An LLM-powered command-line agent designed to help you work faster and smarter on your Python projects.
This assistant can read, edit, and run your Python files — acting as a hands-on coding partner that learns from your codebase and interacts with it directly.
💬 Natural language interface — Talk to your coding assistant right from the terminal
🧩 Understands your codebase — Reads and analyzes your Python files for context
🛠️ Edits and improves code — Refactors, documents, or extends code upon requestt
🔗 Powered by the Gemini API — Uses Google’s latest LLM for reliable and context-aware responses
- The agent scans your local project directory for Python files.
- You give natural-language commands (e.g. “Optimize this function” or “Add error handling”).
- It reads and modifies your code intelligently using the Gemini API.
- You can run the updated code directly from the CLI to see results.
AI agent: What would you like to do?
Optimize my main.py for readability.
AI agent: Updated main.py successfully. Would you like to run it? (y/n)
y
AI agent: main.py optimized!
This project was built to explore how LLMs can act as coding agents, bridging the gap between human intent and machine execution.
It’s a practical example of agentic AI — systems that can reason, plan, and take meaningful action within a software environment.