lab-more-project-chat 0.1.0

A local project chat assistant with safe file tools and slash commands.

Local Project Chat Agent

An AI-powered command-line agent for exploring and analyzing local codebases using natural language and LLM-based tool calling. It provides safe access to files through built-in tools like ls, cat, grep, calculate, and compact.

---

Demo

---

Features

• Safe local file inspection with path validation (prevents absolute paths and traversal attacks)
• Manual slash commands (/ls, /cat, /grep, /calculate, /compact)
• Automatic LLM-based tool calling
• One-shot CLI usage
• --debug flag to display tool calls
• --provider flag for model selection
• Full testing suite (doctests, integration tests, flake8, coverage)

---

Installation

pip install -r requirements.txt

Usage

python chat.py
python chat.py "what is 2 + 2?"
python chat.py --debug "what files are in the .github folder?"
python chat.py --provider groq "show me README.md"

Example: Webscraping Project

This example is good because it shows the agent answering a high-level question about a real scraping project.

$ cd test_projects/webscraping_project
$ python ../../chat.py "what is this project about?"
The project is designed to scrape product data from eBay listings, including titles, prices, and links.

Example: Markdown Compiler

This example is good because it shows the agent inspecting implementation details across source files.

$ cd test_projects/markdown_compiler
$ python ../../chat.py "find def in *.py"
def compile_markdown(file_path):
def parse_headers(text):
def render_html(content):

Example: Mia.Urosevic.github.io

This example is good because it shows the agent reading and summarizing files from a real webpage project.

$ cd test_projects/Mia.Urosevic.github.io
$ python ../../chat.py "show me README.md"
This project is a personal website built using HTML, CSS, and JavaScript.