A lightweight, local versioning tool for any project. Zipoc lets you initialize a repository, create commits of your working directory, and view them in the terminal or a simple web UI.
Features
- Initialize a project repository in
.zipoc/ - Create commits that snapshot your project files
- View commits via a web UI
- Export commits from hash
- Delete the repository
- View commits in the terminal
- Revert working directory to old commit from hash
- Browse files on specific commit through web UI
- AI overview between commits
Installation
You can install Zipoc directly from pip
# ( NOT RELEASED YET!)
python -m pip install zipocUsage
Zipoc exposes a simple CLI via zipoc <command>
Help
Initialize a repository
Creates a .zipoc/ folder with a config.json that records project metadata.
You’ll be asked for:
- Project name
- Project description (optional)
Make a commit
Creates a new commit under .zipoc/commits/<hash>/ containing:
metadata.jsonwith commit hash, message, timestamp, and authorfiles/directory with a snapshot copy of your project files (common folders like.git,__pycache__, and virtual envs are ignored)
View commits
Start the viewer. View commits and other data about your repository in either a localhosted web UI or your terminal
# Web UI zipoc view --web # Terminal UI (In the near future...) zipoc view --terminal
Delete repository
Removes the .zipoc/ folder and all tracked data. This is irreversible.
Made with <3 by jim
