Zor: An Open-Source Claude Code-like Tool¶
Powerful AI assistance for your codebase
What is Zor?¶
Zor is an open-source command-line tool that brings AI-powered code assistance directly to your terminal. Inspired by tools like Claude Code, Zor helps developers understand, modify, and improve their codebases through natural language interactions.
Key Features¶
- Contextual Code Understanding: Zor analyzes your entire codebase to provide relevant answers and suggestions
- Interactive Mode: Have ongoing conversations about your code
- File Editing: Edit files using natural language instructions
- Test Generation: Automatically create unit tests for your code
- Refactoring: Implement complex refactoring across multiple files
- Git Integration: Commit changes directly through Zor
Quick Demo¶
Tech Stack¶
- Python: Core language (3.9+)
- Gemini API: Powers AI code understanding and generation
- Typer: Command-line interface framework
- Rich: Beautiful terminal output formatting
- Google GenerativeAI: Client library for Gemini models
Getting Started¶
Installation¶
pip install zor
Or install from source:
git clone https://github.com/arjuuuuuunnnnn/zor.git
cd zor
pip install -e .
Setup Guide¶
- Get a Gemini API Key:
- Visit Google AI Studio
-
Create an account and generate an API key
-
Configure Zor:
bash zor setup -
Enter your Gemini API key when prompted
-
Verify Installation:
bash zor help
Available Commands¶
| Command | Description |
|---|---|
zor ask |
Ask about your codebase |
zor init |
Create a new project with Zor |
zor edit |
Edit a file with natural language |
zor commit |
Create a git commit |
zor interactive |
Start an interactive session |
zor history |
View conversation history |
zor generate_test |
Generate tests for a file |
zor refactor |
Refactor code across multiple files |
zor config |
View or update configuration |
zor setup |
Configure your Gemini API key |
zor help |
Show available commands |
Detailed Usage¶
Asking About Your Code¶
zor ask "How does the rate limiting work in this codebase?"
Editing Files¶
zor edit path/to/file.py "Add error handling for network failures"
Interactive Mode¶
zor interactive
Create or Initialize new project¶
zor init "create a modern React portfolio app for a software engineer with dark theme"
To know more about a command¶
zor <command> --help
Contributing¶
We welcome contributions of all kinds! See our Contributing Guide for more details.
License¶
Zor is licensed under the MIT License.
Contact & Support¶
- GitHub Issues: For bug reports and feature requests
- Email: arjunbanur27@gmail.com