zor 0.0.4

An Open-Source Claude Code like tool

Zor

An Open-Source Claude Code-like Tool

Overview

Zor is a powerful command-line tool that brings AI-powered code assistance to your terminal. Using the Gemini API, Zor helps you understand, modify, and improve your codebase through natural language.

Think of it as an open-source alternative to tools like Claude Code - your AI pair programmer in the terminal.

Features

• 🧠 Contextual Understanding: Zor analyzes your entire codebase for informed assistance
• 💬 Interactive Mode: Have conversations about your code
• ✏️ Edit Files: Make changes using natural language instructions
• 🧪 Generate Tests: Automatically create tests for your code
• 🔄 Refactor Code: Implement complex changes across multiple files
• 🔧 Git Integration: Commit changes directly from Zor
• 🧠 Project Creation: Create a new projects with description provided

Quick Demo

Installation

pip install zor

Quick Start

1. Configure your API key:

   zor setup
   

2. Ask about your code:

   zor ask "How does the file reading in context.py work?"
   

3. Start an interactive session:

   zor interactive
   

4. Create new Project with Zor:

   zor init "create a modern React portfolio app for a software engineer with dark theme"
   

Documentation

For complete documentation, visit our Documentation.

Example Usage

Generate Tests

zor generate_test zor/context.py

Edit a File

zor edit zor/main.py "Add better error handling to the setup command"

Refactor Code

zor refactor "Improve error handling across the codebase by using custom exceptions"

Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

License

Zor is licensed under the MIT License.

Acknowledgements

• Thanks to all contributors who have helped shape this project
• Inspired by tools like Claude Code and GitHub Copilot