# shōmei (証明)
> your work deserves to be seen
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://pypi.org/project/shomei/)
**shōmei** (証明, pronounced "shoh-may") means "proof" in Japanese. because sometimes you just need proof that you weren't on vacation for the past year.
this CLI tool mirrors your corporate commits to your personal GitHub. no code, no secrets, just timestamps. your contribution graph gets the credit it deserves, and your company's IP stays safe.
## the problem
you've probably seen posts like this:
look, we all know GitHub's green squares don't define you as a developer. but when you're job hunting and your profile looks dead because you've been shipping code from a work account? that's annoying.
lots of developers use separate emails for work, and when they leave a company, their personal profile makes it look like they took a year off. recruiters don't always get it. this tool is for those times when you just want your graph to reflect reality.
**shōmei fixes this. safely.**
## features
- **zero IP leakage** - creates empty commits with just dates, no code
- **dead simple** - one command, that's it
- **contribution proof** - updates your GitHub graph to show you were actually working
- **your commits only** - filters by your email, won't touch anyone else's work
- **dry-run mode** - preview before you commit (pun intended)
- **private repos** - option to mirror to a private repo if you want
## quick start
### installation
```bash
pip install shomei
```
### usage
```bash
# go to any repo where you've been committing with your work email
cd ~/work/cool-project
# run shomei
shomei
# follow the prompts, it'll ask for:
# - your personal GitHub username
# - what to call the mirror repo
# - your GitHub personal access token
# that's it! check your contribution graph in a few minutes
```
#### example session
### options
```bash
# check your shomei version
shomei --version
# preview what would happen (no changes made)
shomei --dry-run
# create a private mirror repo
shomei --private
```
## how it works
1. scans your git log for commits with your email
2. extracts just the commit dates (nothing else!)
3. creates a new repo on your personal GitHub
4. uses GitHub's API to create empty commits with those dates
5. generates a beautiful README for your mirrored repo
6. boom, your contribution graph now shows your real activity
**important**: no code ever leaves your machine. we only send timestamps to GitHub's API. your company's IP stays exactly where it is.
## github token setup
you'll need a GitHub personal access token with `repo` permissions:
1. go to [GitHub Settings → Developer settings → Personal access tokens](https://github.com/settings/tokens)
2. click "Generate new token (classic)"
3. give it a name like "shomei"
4. check the `repo` checkbox (this lets shomei create repos and commits)
5. generate and copy the token
6. use it when shomei asks for it
**pro tip**: save the token somewhere safe (like a password manager). GitHub only shows it once.
## contributing
got ideas? found a bug? want to add a feature? hell yeah, we'd love your help!
check out [CONTRIBUTING.md](CONTRIBUTING.md) for how to get started.
quick version:
1. fork it
2. make your changes
3. test it
4. send a PR
we're super chill about contributions. if you're not sure about something, just open an issue and ask!
## development
```bash
# clone
git clone https://github.com/petarran/shomei.git
cd shomei
# install in dev mode
pip install -e .
# run it
shomei --help
```
## faq
**Q: Is this safe?**
A: yes. shomei only sends commit dates to GitHub's API. no code, no commit messages (beyond "ci(shōmei): sync work contribution"), no file names. your company's IP never touches the internet.
**Q: Will this get me in trouble?**
A: we're not lawyers, but: you're not exposing any proprietary code or information. just timestamps. that said, check your company's policies if you're worried.
**Q: Does this work with private repos?**
A: yep! use the `--private` flag to create a private mirror repo.
**Q: What if I want to delete everything later?**
A: just delete the mirror repo from GitHub. your original work repo is never touched.
**Q: Can I customize the commit messages?**
A: not yet, but that's a great idea! open an issue or PR if you want to add this.
**Q: Why not just change the git config on my work repos?**
A: because then you'd be committing to company repos with your personal email, which might break things or violate policies. shomei keeps everything separate.
## license
MIT - do whatever you want with it.
## disclaimer
shōmei is a tool to help developers showcase their work. use it responsibly:
- no company code or secrets are exposed (we only send dates)
- always check your employment agreement if you're paranoid
- the authors aren't responsible if you use this in weird ways
## credits
built with:
- [click](https://click.palletsprojects.com/) - cli magic
- [rich](https://rich.readthedocs.io/) - pretty terminal output
- [requests](https://requests.readthedocs.io/) - http for humans
---
made with love for developers who actually ship code
if this helped you, give it a star on GitHub!
Raw data
{
"_id": null,
"home_page": "https://github.com/petarran/shomei",
"name": "shomei",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "git, github, contributions, privacy, corporate, sanitize",
"author": "shomei contributors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/06/08/43e99c09818be8fd5a0cfebbc5eeb4a137f48647229f5f4b468fe0e16055/shomei-1.0.2.tar.gz",
"platform": null,
"description": "# sh\u014dmei (\u8a3c\u660e)\n\n> your work deserves to be seen\n\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n[](https://pypi.org/project/shomei/)\n\n**sh\u014dmei** (\u8a3c\u660e, pronounced \"shoh-may\") means \"proof\" in Japanese. because sometimes you just need proof that you weren't on vacation for the past year.\n\nthis CLI tool mirrors your corporate commits to your personal GitHub. no code, no secrets, just timestamps. your contribution graph gets the credit it deserves, and your company's IP stays safe.\n\n\n\n## the problem\n\nyou've probably seen posts like this:\n\n\n\nlook, we all know GitHub's green squares don't define you as a developer. but when you're job hunting and your profile looks dead because you've been shipping code from a work account? that's annoying.\n\nlots of developers use separate emails for work, and when they leave a company, their personal profile makes it look like they took a year off. recruiters don't always get it. this tool is for those times when you just want your graph to reflect reality.\n\n**sh\u014dmei fixes this. safely.**\n\n## features\n\n- **zero IP leakage** - creates empty commits with just dates, no code\n- **dead simple** - one command, that's it\n- **contribution proof** - updates your GitHub graph to show you were actually working\n- **your commits only** - filters by your email, won't touch anyone else's work\n- **dry-run mode** - preview before you commit (pun intended)\n- **private repos** - option to mirror to a private repo if you want\n\n## quick start\n\n### installation\n\n```bash\npip install shomei\n```\n\n### usage\n\n```bash\n# go to any repo where you've been committing with your work email\ncd ~/work/cool-project\n\n# run shomei\nshomei\n\n# follow the prompts, it'll ask for:\n# - your personal GitHub username\n# - what to call the mirror repo\n# - your GitHub personal access token\n\n# that's it! check your contribution graph in a few minutes\n```\n\n#### example session\n\n\n\n### options\n\n```bash\n# check your shomei version\nshomei --version\n\n# preview what would happen (no changes made)\nshomei --dry-run\n\n# create a private mirror repo\nshomei --private\n```\n\n## how it works\n\n1. scans your git log for commits with your email\n2. extracts just the commit dates (nothing else!)\n3. creates a new repo on your personal GitHub\n4. uses GitHub's API to create empty commits with those dates\n5. generates a beautiful README for your mirrored repo\n6. boom, your contribution graph now shows your real activity\n\n**important**: no code ever leaves your machine. we only send timestamps to GitHub's API. your company's IP stays exactly where it is.\n\n## github token setup\n\nyou'll need a GitHub personal access token with `repo` permissions:\n\n1. go to [GitHub Settings \u2192 Developer settings \u2192 Personal access tokens](https://github.com/settings/tokens)\n2. click \"Generate new token (classic)\"\n3. give it a name like \"shomei\"\n4. check the `repo` checkbox (this lets shomei create repos and commits)\n5. generate and copy the token\n6. use it when shomei asks for it\n\n**pro tip**: save the token somewhere safe (like a password manager). GitHub only shows it once.\n\n## contributing\n\ngot ideas? found a bug? want to add a feature? hell yeah, we'd love your help!\n\ncheck out [CONTRIBUTING.md](CONTRIBUTING.md) for how to get started.\n\nquick version:\n\n1. fork it\n2. make your changes\n3. test it\n4. send a PR\n\nwe're super chill about contributions. if you're not sure about something, just open an issue and ask!\n\n## development\n\n```bash\n# clone\ngit clone https://github.com/petarran/shomei.git\ncd shomei\n\n# install in dev mode\npip install -e .\n\n# run it\nshomei --help\n```\n\n## faq\n\n**Q: Is this safe?**\nA: yes. shomei only sends commit dates to GitHub's API. no code, no commit messages (beyond \"ci(sh\u014dmei): sync work contribution\"), no file names. your company's IP never touches the internet.\n\n**Q: Will this get me in trouble?**\nA: we're not lawyers, but: you're not exposing any proprietary code or information. just timestamps. that said, check your company's policies if you're worried.\n\n**Q: Does this work with private repos?**\nA: yep! use the `--private` flag to create a private mirror repo.\n\n**Q: What if I want to delete everything later?**\nA: just delete the mirror repo from GitHub. your original work repo is never touched.\n\n**Q: Can I customize the commit messages?**\nA: not yet, but that's a great idea! open an issue or PR if you want to add this.\n\n**Q: Why not just change the git config on my work repos?**\nA: because then you'd be committing to company repos with your personal email, which might break things or violate policies. shomei keeps everything separate.\n\n## license\n\nMIT - do whatever you want with it.\n\n## disclaimer\n\nsh\u014dmei is a tool to help developers showcase their work. use it responsibly:\n\n- no company code or secrets are exposed (we only send dates)\n- always check your employment agreement if you're paranoid\n- the authors aren't responsible if you use this in weird ways\n\n## credits\n\nbuilt with:\n\n- [click](https://click.palletsprojects.com/) - cli magic\n- [rich](https://rich.readthedocs.io/) - pretty terminal output\n- [requests](https://requests.readthedocs.io/) - http for humans\n\n---\n\nmade with love for developers who actually ship code\n\nif this helped you, give it a star on GitHub!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Show off your coding contributions without leaking corporate IP",
"version": "1.0.2",
"project_urls": {
"Documentation": "https://github.com/petarran/shomei#readme",
"Homepage": "https://github.com/petarran/shomei",
"Issues": "https://github.com/petarran/shomei/issues",
"Repository": "https://github.com/petarran/shomei"
},
"split_keywords": [
"git",
" github",
" contributions",
" privacy",
" corporate",
" sanitize"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "beb0f6076ccfe2e39864783c11282477a1c483936ddcb0b85848aa10f6b7c23b",
"md5": "12e80e1818c97eb4994c8fb6a12f8a0f",
"sha256": "d79a75a4e13bd08a5afe38deae1394ddd729ed348913884793070b6f895d04a7"
},
"downloads": -1,
"filename": "shomei-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "12e80e1818c97eb4994c8fb6a12f8a0f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 14398,
"upload_time": "2025-10-10T13:26:36",
"upload_time_iso_8601": "2025-10-10T13:26:36.741026Z",
"url": "https://files.pythonhosted.org/packages/be/b0/f6076ccfe2e39864783c11282477a1c483936ddcb0b85848aa10f6b7c23b/shomei-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "060843e99c09818be8fd5a0cfebbc5eeb4a137f48647229f5f4b468fe0e16055",
"md5": "f1591da73624656938b0eace1ec3edb1",
"sha256": "9745a1a140b89995de0bb32fd323c6ac19b50bf50a1d4152ecdab04cdbd09b19"
},
"downloads": -1,
"filename": "shomei-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "f1591da73624656938b0eace1ec3edb1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 15277,
"upload_time": "2025-10-10T13:26:38",
"upload_time_iso_8601": "2025-10-10T13:26:38.256621Z",
"url": "https://files.pythonhosted.org/packages/06/08/43e99c09818be8fd5a0cfebbc5eeb4a137f48647229f5f4b468fe0e16055/shomei-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-10 13:26:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "petarran",
"github_project": "shomei",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "shomei"
}
JSON
