pronounced: shoh-may (証明)
proof of your work. mirror your corporate commits to personal GitHub without leaking any code.

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