AI Coding Agent

This project is a helpful AI coding agent designed to assist with project management and development tasks by executing commands directly within a project's working directory. The agent can list, read, write, and execute files, acting as a powerful tool for automated code management.

⚠️Security Warning

This application is designed to execute code and modify files on your system. It is a powerful tool but comes with significant security risks. It is a known feature of this app that it has the ability to overwrite files and execute arbitrary code. Only use this agent on projects you trust and with full awareness of its capabilities.

🚀 Features

• File & Directory Operations: List and read the contents of files and directories within the project.

• Code Execution: Execute Python files with optional arguments.

• File Management: Write or overwrite files, allowing for dynamic changes to the project structure.

• Project Context: All operations are performed relative to the current working directory, giving the agent a complete view of the project.

🛠️ Getting Started

This project uses uv for dependency management. Follow these steps to set up the environment.

Prerequisites Python 3.10 or higher installed on your system.

The uv package manager. If you don't have it, you can install it using pipx:

pipx install uv

Installation

Clone this repository to your local machine:

git clone https://github.com/hasheddev/basic-coding-assistant.git
cd basic-coding-assistant

Install the required dependencies using uv:

uv sync

💡 Usage

Supply path to project an absolute path in function/call_function.py WORKING_DIR variable or fiddle with the calculator app within the repository The agent is designed to be run from the command line with a specific prompt. You can also add an optional flag for more detailed output.

uv run main.py "Your prompt here"

To enable verbose output, add the --verbose flag:

uv run main.py "Your prompt here" --verbose