- Shell 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .forgejo/workflows | ||
| acct-group/onepassword-cli | ||
| app-admin | ||
| app-office/drawio-desktop-bin | ||
| dev-cpp/cpr | ||
| dev-libs/sfl | ||
| dev-python | ||
| dev-util/codex | ||
| games-simulation/openloco | ||
| media-video/jellyfin-desktop | ||
| metadata | ||
| net-im | ||
| profiles | ||
| sci-geosciences/supercell-wx | ||
| sys-auth/libfprint | ||
| x11-themes/geany-themes | ||
| .gitignore | ||
| AGENTS.md | ||
| README.md | ||
jrittenh-overlay
Personal Gentoo overlay (profiles/repo_name: jrittenh). Actively maintained: app-editors/cursor, sys-auth/libfprint, and app-admin/1password-cli (CLI only). Remaining ebuilds are experimental or candidates for removal. A discover-portage-backend ebuild is planned but not in the tree yet.
The 1Password desktop app is best tracked in gentoo-zh (app-admin/1password). That ebuild installs op under /opt/1Password/ but does not put it on your PATH or apply the CLI setgid group—use app-admin/1password-cli from this overlay alongside it.
Install from GitHub
1. Sync the repository
sudo mkdir -p /var/db/repos/jrittenh
sudo git clone [https://github.com/jrittenh/jrittenh-overlay.git](https://github.com/jrittenh/jrittenh-overlay.git) /var/db/repos/jrittenh
Or use Portage's git sync (recommended so eix-sync / emaint can update it):
sudo install -d /etc/portage/repos.conf
sudo cp repos.conf.example /etc/portage/repos.conf/jrittenh.conf
sudo emaint sync -r jrittenh
2. Use the overlay
With repos.conf in place, Portage discovers jrittenh automatically after sync—no eselect repository step required while the repo is only on GitHub.
sudo emaint sync -r jrittenh
portageq repos_config /var/db/repos/jrittenh | head
Optional one-time registration via eselect (alternative to copying repos.conf.example yourself):
sudo eselect repository add jrittenh git [https://github.com/jrittenh/jrittenh-overlay.git](https://github.com/jrittenh/jrittenh-overlay.git)
sudo emaint sync -r jrittenh
Once this overlay is listed in the Gentoo Overlays catalog, you can instead use eselect repository enable jrittenh.
After repos.conf exists with auto-sync = yes, eix-sync or emaint sync -a keeps the tree current.
3. Accept keywords / licenses / masks as needed
Default ACCEPT_LICENSE="-* @FREE" blocks proprietary packages. Cursor requires accepting the overlay license:
app-editors/cursor cursor
Add that to /etc/portage/package.license (or allow cursor in ACCEPT_LICENSE globally). The license text is in licenses/cursor in this repo and points to Cursor Terms of Service.
Several packages use ~amd64 or live ebuilds. Adjust /etc/portage/package.accept_keywords, package.unmask, and package.mask for your system. Live libfprint-9999 needs a keyword entry, for example:
sys-auth/libfprint **
Updating
| Method | When |
|---|---|
eix-sync |
Repo listed in /etc/portage/repos.conf with auto-sync = yes |
emaint sync -r jrittenh |
Sync only this overlay |
git -C /var/db/repos/jrittenh pull |
Manual clone without repos.conf |
After syncing, run eix-update if you use eix for indexing.
1Password CLI (op)
Typical setup: desktop from gentoo-zh, CLI from this overlay.
- Enable and sync gentoo-zh if you use the GUI.
- Sync jrittenh and merge:
sudo emerge -av acct-group/onepassword-cli app-admin/1password-cli::jrittenh
/etc/portage/package.license:
app-admin/1password-cli all-rights-reserved
- Add yourself to the CLI group and start a new session:
sudo gpasswd -a "${USER}" onepassword-cli
- Sign in (first time:
op account addper upstream docs):
eval "$(op signin)"
op whoami
Quick check without Portage: if you only installed gentoo-zh’s desktop, try /opt/1Password/op whoami. If that works but op does not, you were missing a /usr/bin/op symlink and setgid—install app-admin/1password-cli above instead of hand-copying the binary.
Packages
| Category | Package | Status |
|---|---|---|
| app-editors | cursor | Maintained; golden-channel .deb repack |
| app-admin | 1password-cli | Maintained; op CLI (pairs with gentoo-zh desktop) |
| sys-auth | libfprint | Maintained; live ebuild tracking upstream fork |
| dev-libs | sfl | Dependency for openloco; verify before use |
| games-simulation | openloco | Experimental |
| media-video | jellyfin-desktop | Parked; old Qt ebuild — plan rewrite for CEF-based client |
| (planned) | discover-portage-backend | Not yet added |
Install elsewhere (removed from this overlay)
| Software | Suggested source |
|---|---|
| 1Password desktop only | gentoo-zh app-admin/1password |
| Gittyup | Flathub com.github.Murmele.Gittyup (Portage build was dependency-heavy and unmaintained here) |
| draw.io desktop | app-office/drawio-desktop-bin in ::gentoo |
Requirements
- Portage with EAPI 9 support (Council-approved 2025-12; included in current stable Portage).
- Synced
gentootree as master (metadata/layout.conf).
Layout & Maintainer Workflow
Standard Portage overlay layout (EAPI 9, thin manifests):
metadata/layout.conf— mastersgentoo,manifest-hashes, sync protocolsmetadata/project.xml— overlay maintainerprofiles/repo_name,profiles/eapi,profiles/descriptionAGENTS.md— Ebuild development standards, EAPI 9 conventions, and Portage sandbox workarounds for AI coding assistants- Per-package
metadata.xmlunder each package directory - Category trees under
app-*,dev-*,games-*,media-*,sys-*
Regenerate manifests and run QA checks using pkgdev and pkgcheck:
pkgdev manifest
pkgcheck scan
Contributing / Upstream Overlay
This overlay is personal today. Before requesting inclusion in the Gentoo Overlays project (eselect repository list), expect CI (pkgcheck scan), QA-clean ebuilds, and stabilization of stale packages.
Bug reports and fixes are welcome via GitHub issues and pull requests. Automated agents and contributors should adhere to the guidelines in AGENTS.md.
License
Ebuilds are licensed per their LICENSE= fields. Overlay metadata and documentation are offered as-is for personal use.