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.

• Demo

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

• Get an OpenRouter API key
• For web search
  • Get a Google API key
  • Get a Google Search Engine ID

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.