No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-05 09:59:40 -05:00
.forgejo/workflows feat(workflow): add branch validation workflow 2026-11-03 11:56:34 -05:00
acct-group/onepassword-cli fix(group): enforce non-system group identifier for password client 2026-11-03 15:06:15 -05:00
app-admin feat(admin): update password client to 2.41.1 and fix permissions 2026-11-03 15:06:21 -05:00
app-office/drawio-desktop-bin feat: updates from mal and zehnra 2026-07-13 16:16:22 -04:00
dev-cpp/cpr feat: add cpr for supercell-wx 2026-07-27 13:54:20 -04:00
dev-libs/sfl fix(library): correct license identifier and variable ordering 2026-11-05 09:53:50 -05:00
dev-python feat: add pyogrio 2026-07-27 22:13:03 -04:00
dev-util/codex feat(codex): add version 0.166.0 and manifest 2026-11-03 11:14:04 -05:00
games-simulation/openloco fix(simulation): anchor range patterns in build file replacement 2026-11-05 09:59:40 -05:00
media-video/jellyfin-desktop fix: downgrade EAPI to 8 across ebuilds and profiles 2026-10-09 12:40:19 -04:00
metadata fix(metadata): use single-line properties in layout configuration 2026-11-03 11:51:21 -05:00
net-im feat(zoom): add version 7.2.5.6661 and update manifest 2026-11-03 11:13:39 -05:00
profiles fix: downgrade EAPI to 8 across ebuilds and profiles 2026-10-09 12:40:19 -04:00
sci-geosciences/supercell-wx fix: continue patching supercell-wx 2026-07-28 16:57:31 -04:00
sys-auth/libfprint fix: downgrade EAPI to 8 across ebuilds and profiles 2026-10-09 12:40:19 -04:00
x11-themes/geany-themes feat: updates from mal and zehnra 2026-07-13 16:16:22 -04:00
.gitignore feat: add readme and gitignore 2026-09-09 22:09:14 -04:00
AGENTS.md docs: add AGENTS.md and update maintainer workflow in README 2026-11-05 09:53:28 -05:00
README.md docs: add AGENTS.md and update maintainer workflow in README 2026-11-05 09:53:28 -05:00

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.

  1. Enable and sync gentoo-zh if you use the GUI.
  2. Sync jrittenh and merge:
sudo emerge -av acct-group/onepassword-cli app-admin/1password-cli::jrittenh
  1. /etc/portage/package.license:
app-admin/1password-cli all-rights-reserved
  1. Add yourself to the CLI group and start a new session:
sudo gpasswd -a "${USER}" onepassword-cli
  1. Sign in (first time: op account add per 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 gentoo tree as master (metadata/layout.conf).

Layout & Maintainer Workflow

Standard Portage overlay layout (EAPI 9, thin manifests):

  • metadata/layout.conf — masters gentoo, manifest-hashes, sync protocols
  • metadata/project.xml — overlay maintainer
  • profiles/repo_name, profiles/eapi, profiles/description
  • AGENTS.md — Ebuild development standards, EAPI 9 conventions, and Portage sandbox workarounds for AI coding assistants
  • Per-package metadata.xml under 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.