⚠️ This project is currently under active development and in its early stages. LLM Code is using LLM Code to build itself.
LLM Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster through natural language commands. This tool integrates directly with your development environment, allowing you to edit files, navigate directories, and interact with an AI assistant.
Inspired by Anthropic's Claude Code, this project aims to provide a similar interactive coding experience while being open-source and customizable.
LLMCode.-.Walkthrough.mp4
- 🤖 Interactive AI coding assistant
- 📁 File and directory operations
- ✏️ File editing and appending
- 🔍 Codebase context understanding
- ⚙️ Configurable settings
- 🌈 Colored terminal output
- Clone the repository:
git clone https://github.com/futureHQ/LLMCode.git
cd LLMCode- Install dependencies:
pip install -r requirements.txt- Configure your API key:
python main.py
/config set apiKey YOUR_API_KEYStart the application:
python main.py-
Basic Commands:
/help- Show help message/exit,/quit- Exit the program/pwd,/cwd- Print working directory
-
File Operations:
/ls [path]- List directory contents/tree [path]- Show directory structure/cat <file>- Display file contents/write <file>- Create/overwrite a file/append <file>- Append to existing file
-
Directory Operations:
/cd <path>- Change directory/mkdir <path>- Create directory
-
Configuration:
/config set <key> <value>- Set configuration value/config list- List all configurations/config show- Show active configuration
-
Context:
/context [path],/#- Get workspace context
The configuration file is stored at ~/.llm_code_config.json. You can configure:
apiKey- Your API keybaseUrl- API base URL (default: https://api.openai.com/v1)model- AI model to usedebug- Enable/disable debug mode
Start the application:
python main.py- First, get the context of your codebase:
[myproject]> /#
Getting context from: /path/to/myproject
Found 3 file(s) in workspace...
[myproject]> Now I understand your codebase. How can I help?- Or use tree to understand the project structure:
[myproject]> /tree
Directory tree for: /path/to/myproject
└── src
├── main.py
├── utils
│ └── helpers.py
└── tests
└── test_main.py
[myproject]> Can you explain the project structure?- Get context for specific files:
[myproject]> /context src/main.py
Getting context from: /path/to/myproject/src/main.py
Found 1 file(s) in workspace...
[myproject]> Can you help me modify the main function?- Example coding assistance:
[myproject]> /#
Getting context from current directory...
[myproject]> Can you add error handling to the process_data function?
Assistant: I see the process_data function in main.py. Here's how we can add error handling...- Always provide context using
/context,/#, or/treebefore asking for code modifications - Use
/context <file>when working on specific files - Use
/treeto get an overview of project structure - Use
/#to get context of the current directory