02_git
A Git implementation written in TypeScript from scratch. Supports core Git operations including init, add, commit, log, status, branching, checkout, and three-way merge with conflict detection.
Install
npm install -g 02_git
Usage
There are two ways to use 02_git:
With global install
If you installed globally with npm install -g 02_git, you get the ts-git command:
ts-git init
ts-git add .
ts-git commit -m "initial commit"
ts-git log
With npx (no install needed)
All commands also work via npx — just prefix with npx 02_git:
npx 02_git init
npx 02_git add .
npx 02_git commit -m "initial commit"
npx 02_git log
Commands
ts-git init Initialize a new repository
ts-git add <path> Stage a file (use . to stage all)
ts-git commit -m "message" Commit staged changes
ts-git log Show commit history
ts-git status Show working tree status
ts-git branch <name> Create a new branch
ts-git checkout <name> Switch to a branch
ts-git curr-branch Show the current branch
ts-git merge <branch> -m "msg" Merge a branch into current
ts-git c-merge <branch> Check for merge conflicts without merging
ts-git help Show help message
How it works
02_git stores data in a .tsgit directory with the same conceptual structure as Git:
- Objects — content-addressed blobs, trees, and commits stored by SHA-1 hash
- Refs — branch pointers stored as files under
refs/heads/ - HEAD — symbolic ref pointing to the current branch
- Index — staging area mapping file paths to blob hashes
Merges use a three-way merge algorithm that finds the common ancestor and detects conflicts when both branches modify the same file differently.
License
MIT