██████ ██ ██ ███ ██ ██████ ██ ██ ██
██ ██ ██ ████ ██ ██ ██ ██ ██ ██
███████ ████ ██ ██ ██ ██████ ██ ███
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
██████ ██ ██ ████ ██ ██ ██ ██ ██
SYNCHRONIZED REPOSITORY INDEXING EXTENSION
A Next-Generation Version Control System Built For Simplicity, Safety, And Speed !!
Features • Installation • Quick Start • Documentation • Contributing
SYNRIX (Synchronized Repository Indexing Extension) Is A Modern, Industry-Grade Version Control System That Addresses The Pain Points Of Traditional VCS Tools. Built From The Ground Up In C# With .NET 8.0, SYNRIX Combines The Power Of Distributed Version Control With An Intuitive, User-Friendly Interface.
SYNRIX Operates On One Core Principle:
"Do What You Mean, Not What You Say"
We Believe Version Control Should Be:
- ✅ Intuitive - Commands That Make Sense
- ✅ Safe - Data Protection By Default
- ✅ Powerful - Advanced Features When You Need Them
- ✅ Fast - Optimized For Performance
- Complete Reflog Protection - Every Operation Is Logged And Recoverable
- Simple Undo/Redo -
synrix undoAndsynrix redoCommands - Lost Commit Recovery - Find And Recover Orphaned Commits
- Confirmation Prompts - Destructive Operations Require Explicit Confirmation
- SHA-256 Content Addressing - Cryptographically Secure Object Storage
- GZIP Compression - Efficient Storage With Up To 70% Space Savings
- Three-Way Merge Algorithm - Intelligent Conflict Resolution
- Interactive Rebase - Full Control Over Commit History
- Pack File Support - Optimized Storage For Large Repositories
- Local & HTTP Remotes - Work Offline Or Collaborate Online
- Smart Push/Pull/Fetch - Efficient Network Operations
- Branch Management - Lightweight Branches With Full History
- Tag Support - Annotated And Lightweight Tags
- Clear Command Names - No Ambiguous Multi-Purpose Commands
- Colorized Output - Visual Feedback For All Operations
- Detailed Status - Know Exactly What's Happening In Your Repository
- Comprehensive Help - Built-In Documentation For Every Command
# Git's Confusing Multi-Purpose Commands
git checkout branch-name # Switch Branch? Restore File? Create Branch?
git reset --hard # Dangerous And Unclear
# SYNRIX's Clear, Purpose-Built Commands
synrix switch branch-name # Obviously Switches Branches
synrix restore file.txt # Obviously Restores A File
synrix undo # Obviously Undoes Last Action# Git: Easy To Lose Data
git reset --hard HEAD~3 # POOF! Work Gone Forever
git push --force # Team's Work Potentially Destroyed
# SYNRIX: Data Protection Built-In
synrix reset --hard HEAD~3 # Requires Confirmation + Recoverable Via Reflog
synrix push --force # Shows What Will Be Overwritten + Requires Confirmation
synrix undo # Simple Recovery Mechanism# Git: Cryptic Merge States
git status # Shows Confusing State Messages
# SYNRIX: Clear Conflict Resolution
synrix status # Shows Exactly Which Files Have Conflicts
synrix conflicts # Lists All Conflicts With Line Numbers
synrix resolve <file> # Mark File As Resolved# Git: Complex History Manipulation
git rebase -i HEAD~5 # Opens Editor With Cryptic Instructions
# SYNRIX: Interactive And Intuitive
synrix rebase --interactive # Clear Instructions And Visual Feedback
synrix history --graph # Beautiful Branch Visualization- .NET 8.0 SDK Or Higher
- Windows, Linux, Or MacOS
- PowerShell (Windows) Or Bash (Linux/MacOS)
# Clone The Repository
git clone https://github.com/i8o8i-Developer/Synrix-VCS.git
cd Synrix-VCS
# Build The Project
.\Build.ps1 # Windows PowerShell
./Build.sh # Linux/MacOS Bash
# Add To PATH
# Windows: Add Bin\ Directory To System PATH
# Linux/MacOS: Add Bin/ Directory To ~/.bashrc Or ~/.zshrcsynrix --version
# Output: SYNRIX VERSION 2.0.0 - PRODUCTION RELEASE# Create A New Repository
mkdir MyProject
cd MyProject
synrix init
# Configure User Information
synrix config user.name "Your Name"
synrix config user.email "your.email@example.com"# Create A File
echo "Hello SYNRIX" > README.md
# Stage Changes
synrix add README.md
synrix status # See Staged Changes
# Commit Changes
synrix commit -m "Initial Commit"
# View History
synrix log
synrix log --graph # Visual Branch Representation# Create And Switch To New Branch
synrix branch feature-x
synrix switch feature-x
# Make Changes And Commit
echo "New Feature" > feature.txt
synrix add feature.txt
synrix commit -m "Add Feature X"
# Switch Back And Merge
synrix switch main
synrix merge feature-x# Add Remote Repository
synrix remote add origin https://github.com/username/repo.git
# Push Changes
synrix push origin main
# Pull Changes
synrix pull origin main
# Clone Repository
synrix clone https://github.com/username/repo.git# Undo Last Operation
synrix undo
# Redo Undone Operation
synrix redo
# Find Lost Commits
synrix lost
# Recover Lost Commit
synrix recover <commit-hash>
# Interactive Rebase
synrix rebase --interactive main
# Stash Changes
synrix stash
synrix stash pop
synrix stash list
# Tag Release
synrix tag v1.0.0 -m "Version 1.0.0 Release"We Welcome Contributions From The Community! SYNRIX Is An Open Source Project And We're Excited To Work With Developers Who Share Our Vision.
- Fork The Repository
- Create A Feature Branch (
synrix branch feature/AmazingFeature) - Commit Your Changes (
synrix commit -m "Add AmazingFeature") - Push To Your Fork (
synrix push origin feature/AmazingFeature) - Open A Pull Request
- Follow The Code Of Conduct
- Write Clear, Descriptive Commit Messages
- Add Tests For New Features
- Update Documentation As Needed
- Follow C# Coding Conventions (PascalCase For Public Members)
See CONTRIBUTING.md For Detailed Guidelines.
This Project Adheres To A Code Of Conduct That All Contributors Must Follow. We're Committed To Providing A Welcoming And Inclusive Environment For Everyone.
This Project Is Licensed Under The MIT License - See The LICENSE File For Details.
MIT License
Copyright (c) 2025 SYNRIX Project
Permission Is Hereby Granted, Free Of Charge, To Any Person Obtaining A Copy
Of This Software And Associated Documentation Files (The "Software"), To Deal
In The Software Without Restriction, Including Without Limitation The Rights
To Use, Copy, Modify, Merge, Publish, Distribute, Sublicense, And/Or Sell
Copies Of The Software, And To Permit Persons To Whom The Software Is
Furnished To Do So, Subject To The Following Conditions:
The Above Copyright Notice And This Permission Notice Shall Be Included In All
Copies Or Substantial Portions Of The Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
Anubhav Chaurasia - Original Creator And Lead Developer
i8o8i-WorkStation - Project Maintenance And Development
- The .NET Community For Excellent Tooling And Support
- Contributors Who Have Helped Shape SYNRIX
- Early Adopters Who Provided Valuable Feedback
- The Git Project For Inspiration And Design Insights
- GitHub Repository: https://github.com/i8o8i-Developer/Synrix-VCS
- Issue Tracker: https://github.com/i8o8i-Developer/Synrix-VCS/issues
- Wiki Documentation: https://github.com/i8o8i-Developer/Synrix-VCS/wiki
- Discussions: https://github.com/i8o8i-Developer/Synrix-VCS/discussions
Made With ❤️ By The SYNRIX Community
Star ⭐ This Repository If You Find It Useful!