why shōmei?
simple problem, simple solution
zero IP leakage
only sends commit dates to GitHub's API. no code, no messages, no file names. your company's IP stays safe.
dead simple
one command: shomei
. that's it. follow the prompts, and you're done in 2 minutes.
contribution proof
updates your GitHub graph to show you were actually working. recruiters can see you're active.
your commits only
filters by your email address. won't touch anyone else's work. completely safe.
input validation
validates repo names and tokens to prevent errors. retry loops for bad input.
automatic README
generates a beautiful README for each mirrored repo with stats and badges. free marketing!
dry-run mode
preview what would happen before actually doing it. no surprises.
private repos
option to create private mirror repos if you want. your choice.
installation
get started in seconds
pip install shomei
requires Python 3.10+ and git
quick start
mirror your first repo
# go to any repo where you've been committing with work email
cd ~/work/cool-project
# run shomei
shomei
# follow the prompts:
# - your personal GitHub username
# - mirror repo name
# - GitHub personal access token
# done! check your contribution graph ✨
options
# preview without making changes
shomei --dry-run
# create a private mirror repo
shomei --private
# get help
shomei --help