Hoz - Git-Compatible Version Control System

A full-featured Git implementation in Zig 0.16.0,
built for type safety and performance.
Hoz is the next generation of Git-compatible version control with a clean, modern codebase.

Github | Codeberg

---

Why Hoz?

• Git-Compatible - Works with existing Git repositories and workflows
• Type-Safe - Written in Zig for memory safety and compile-time verification
• Fast - Optimized object database and efficient diff engine
• Portable - Runs anywhere Zig 0.16.0 is available

---

Quick Start

Warning

This project is in active development and now just a toy, please do not use it in production.

Installation

curl -fsSL https://raw.githubusercontent.com/EdwardJoke/hoz-vcs/main/install.sh | bash

Basic Usage

Initialize a new repository:

hoz init my-project
cd my-project

Stage and commit changes:

hoz add .
hoz commit -m "Initial commit"

---

Common Commands

Repository Operations

hoz init           # Create a new repository
hoz clone <url>    # Clone an existing repository

Making Changes

hoz add <file>     # Stage files for commit
hoz commit -m ""   # Record staged changes
hoz status         # Show working tree status
hoz diff           # Show unstaged changes

Branching

hoz branch                    # List branches
hoz branch <name>             # Create a branch
hoz checkout <branch>         # Switch branches
hoz merge <branch>            # Merge branches

History & Inspection

hoz log           # View commit history
hoz show <ref>    # Show commit details
hoz blame <file>  # Show file annotations
hoz describe      # Describe commit using tags
hoz verify-tag    # Verify annotated tag signature
hoz name-rev      # Translate SHA to symbolic name

File Operations

hoz add <file>     # Stage files for commit
hoz rm <file>      # Remove from working tree and index

Remote Collaboration

hoz fetch         # Download objects from remote
hoz push          # Upload objects to remote
hoz pull          # Fetch and merge remote changes

---

Project Status

Hoz is in active development. Core Git functionality is implemented including:

• Object database (blobs, trees, commits, tags)
• Reference management (branches, tags, HEAD)
• Staging area (index)
• Working directory operations
• Diff and merge algorithms

---

Contributing

Contributions welcome. Please ensure just asset passes before submitting changes.

---

License

Apache License 2.0