Skip to content

README.md

Latest commit

 

History

History
109 lines (87 loc) · 4.19 KB

README.md

File metadata and controls

109 lines (87 loc) · 4.19 KB
Raw

Loopy-Code: Your AI-Powered Command-Line Coding Companion

Loopy is an AI coding agent built entirely from the ground up — no frameworks involved. It collaborates with you to write, edit, and reason about code, turning your terminal into an intelligent, conversational development environment.

Loopy Interface

Features

  • Interactive AI Chat: Engage in natural conversations with an AI assistant that understands your codebase and development needs
  • Rich Toolset: Comprehensive set of tools for file operations, code editing, terminal commands, web search, and more
  • Context-Aware Memory: Maintains conversation history and context for more relevant assistance
  • Cost Tracking: Built-in monitoring of API usage and costs
  • Beautiful Terminal UI: Rich, colorful interface with live streaming responses and progress indicators
  • Task Management: Integrated todo system for tracking multi-step development tasks
  • Advanced Search: Powerful codebase and web search capabilities
  • Sub-Agent Delegation: Can delegate complex tasks to specialized sub-agents

Quick Start

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/Mu7annad0/loopy-code.git
cd loopy-code

  2. Install using uv:

    uv tool install -e .

  3. Configure environment: Copy .env.example to .env and add your API keys:

    cp .env.example .env

    Edit .env with your API credentials:

    OPENROUTER_API_KEY="your-openrouter-api-key-here"
MODEL_NAME="your-model-here-from-openrouter"
# Optional: For web search functionality
GOOGLE_API_KEY="your-google-api-key"
GOOGLE_SEARCH_ENGINE_ID="your-search-engine-id"

  4. Launch Loopy:

    loopy

Available Tools

Loopy comes with a comprehensive set of tools that the AI can use to assist you:

File Operations

  • read_file - Read and analyze file contents
  • edit_file - Create, modify, or refactor code files
  • list_directory - Explore project structure and find files

Search & Discovery

  • grep_search - Search for text patterns within files
  • codebase_search - Search across your entire codebase
  • web_search - Search the internet for documentation and examples

Development Workflow

  • cmd_runner - Execute terminal commands and scripts
  • todo_writer - Create and manage development task lists
  • task_memory - Access and manage conversation history

Advanced Features

  • task_delegator - Break down complex tasks into manageable sub-tasks

Project Structure

loopy/
├── src/
|   ├── common/
|   |   ├── utils.py       # Utility functions
│   ├── core/
│   │   ├── agent.py       # Main agent logic and conversation handling
│   │   └── llm.py         # Language model communication
│   ├── tools/             # Available tools and capabilities
│   │   ├── file_editor.py # File creation and editing
│   │   ├── web_search.py  # Internet search functionality
│   │   ├── cmd_runner.py  # Terminal command execution
│   │   └── ...           # Additional tools
│   ├── ui/               # User interface components
│   ├── history/          # Conversation and context management
│   ├── memory/           # Long-term memory and caching
│   ├── prompt/           # System prompts
│   └── loopy_main.py     # Application entry point
├── .env.example          # Configuration template
├── pyproject.toml        # Project metadata and dependencies
└── README.md            # Readme file

Loopy is designed to be your coding companion, helping you write better code faster through intelligent assistance and powerful automation tools.