Git3 Technical Documentation

Complete technical reference for Git3 architecture and implementation

Overview

Git3 is a terminal-based web interface for interacting with the Git3 ecosystem - a fully on-chain GitHub repository importer that stores complete Git history on Irys blockchain with no off-chain dependencies.

Core Concept

Today, every Git repository ultimately lives on someone's server — GitHub, GitLab, Bitbucket. You trust them to keep your code online, preserve history and not censor or remove it. That trust is invisible, but absolute.

Git3 removes that dependency. We connect Git directly to Irys, a decentralized data layer that ensures files and commits are stored permanently and verifiably. Each commit uploaded through Irys receives blockchain-anchored security, giving every version of your repository a cryptographic timestamp and proof of existence.

Key Features

  • ✓GitHub OAuth Integration - Connect your GitHub account to list and import repositories
  • ✓Web3 Wallet Connection - Connect your Ethereum wallet using Thirdweb for blockchain interactions
  • ✓Complete Git History - Import entire Git repositories to Irys with full commit history
  • ✓Direct Blockchain Access - Query Irys blockchain directly using @irys/query
  • ✓Repository as NFT - Each repository lives as a unique on-chain asset
  • ✓x402 Protocol - Agent interoperability and decentralized MCP with payment rails

Quick Start

  1. Connect your GitHub account via OAuth
  2. Connect your Web3 wallet (Ethereum compatible)
  3. Import a repository: git3 import https://github.com/username/repo.git
  4. Browse your on-chain projects: git3 projects