https://github.com/nairbv/vibecoder
An terminal based (IRC-style) LLM-powered coding tool
https://github.com/nairbv/vibecoder
ai-agents ai-coding llm vibe-coding vibecoding
Last synced: 26 days ago
JSON representation
An terminal based (IRC-style) LLM-powered coding tool
- Host: GitHub
- URL: https://github.com/nairbv/vibecoder
- Owner: nairbv
- Created: 2025-04-25T23:53:23.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-15T22:58:52.000Z (6 months ago)
- Last Synced: 2025-08-16T00:37:27.888Z (6 months ago)
- Topics: ai-agents, ai-coding, llm, vibe-coding, vibecoding
- Language: Python
- Homepage:
- Size: 197 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# VibeCoder: Autonomous Code Agent
## Overview
VibeCoder is an autonomous coding agent designed to streamline software engineering tasks. It operates as a command-line REPL (Read-Eval-Print Loop) that interacts with users in real-time to analyze tasks, plan solutions, write code, test, and iteratively improve projects.
## Installation
VibeCoder requires Python 3.8 or newer. To set up the environment, follow these steps:
```bash
# Clone the repository
git clone https://github.com/yourusername/vibecoder.git
cd vibecoder
# Install with dependencies
pip install .
```
## Usage
Once installed, you can start the REPL interface:
```bash
python -m vibecoder.main
```
Upon starting, you'll find VibeCoder responsive to typed commands and prompts. Type `/help` within the REPL for a list of available commands.
## Extending VibeCoder
You can add new tools to enhance the agent's capabilities. Each tool consists of implementing a new subclass of the `Tool` base class located in `vibecoder/tools`, alongside its usage documentation and test cases:
- Create a subclass `NewTool(Tool)` in `vibecoder/tools/new_tool.py`.
- Add a usage description in `vibecoder/prompts/tools/new_tool.md`.
- Write unit tests in `tests/tools/test_new_tool.py`.
For more details, see the documentation in the `docs/` directory.